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This manual provides a detailed description of the software 
I/O drivers for Control Data® CYBER 18 Series 
peripherals. These I/O drivers are utilized by the Mass 
Storage Operating System (MSOS) and the Interactive 
Terminal-Oriented System (ITOS). 

This manual is intended to be used by programmers of 
CYBER 18 software who require a real-time, 
multiprogramming environment. 

The following devices are supported by standard drivers 
common to MSOS and ITOS: 



1867-10/20/40 1868-1 

1866-14 

1827-30/32/60/90 

1829-30/60 

1860-1/2/3/4 

1860-5/6 



Storage module drive 

Cartridge disk drive 

Band/ drum printer 

Card reader 

NRZI magnetic tape 

Phase-encoded magnetic tape 



The following devices are supported by standard drivers 
subject to restrictions as noted: 

1865-1/2 Flexible disk drive (Separate standard 
drivers are available for MSOS and ITOS.) 

1843-2 8-channel CLA (Separate standard drivers 
are available for MSOS and ITOS.) 

1843-1 2-channel CLA (Supported only on ITOS 
COMM18 Systems.) 

1811-1/2 Console display terminal (Supported via the 
1843-2 8-channel CLA on ITOS and MSOS. 
In addition, a driver for a single 1811-1 or -2 
is supported by MSOS only.) 

1827-7 Matrix printer (Supported via the 1843-2 
8-channel CLA on ITOS only.) 



For additional information relative to MSOS and ITOS, 
refer to the following documents: 



Publication 



Publication Number 



Mass Storage Operating System Version 5 
Reference MarMjal 

MSOS 5 Diagnostic Handbook 

MSOS 5 Installation Handbook 

Interactive Terminal-Oriented System (ITOS) 
Version 2 Reference Manual 

ITOS Version 2 Installation Handbook 



96769400 

96769450 
96769410 
96769240 

60475200 



This product is intended for use only as 
described in this document. Control Data 
cannot be responsible for the functioning of 
undescribed features or parameters. 
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INTRODUCTION 



Each peripheral device in a computer system is associated 
with a device driver, the only piece of software that is 
allowed to give direct commands to the device. The driver 
controls execution of the read, write, and motion requests 
that are passed to the monitor by the user programs. 

Each driver normally has three entries: initiator, 
continuator, and timeout (error). Variable parameters 
relating to the device and the driver's working storage are 
contained in the physical device table in a format common 
to all drivers. Functionally, the initiator initializes the 
working storage in the physical device table and initiates 
input/output on an idle device; the continuator drives the 
device to perform the actual requested task. If the 
diagnostic timer detects a device hang-up (lost interrupt), 
the timeout entry is entered. 

Whenever a program requires input or output (I/O) for data 
it is processing, it makes a monitor request to effect the 
desired transfer. The monitor queues the request for 
processing by an I/O driver. A driver may handle more 
than one device of the same type, but requires a separate 
physical device table for each device. 

When a request is queued, the request processor, RW, 
determines if the driver is available. If the driver is not 
busy, its initiator is scheduled, and the request exit 
processpr returns to the caller. 

Motion requests are handled in a similar way. 

Upon entry to the initiator, a call is made to the 
find-next-request routine, which decodes the requestor's 
parameter list and places the information in the physical 
device table. The driver initiates the I/O operation and 
selects some interrupt condition (end-of-operation, data, 
etc.). A diagnostic clock value is set in the physical device 
table, and an exit is made to the dispatcher. 

When the I/O device completes the operation, an interrupt 
is generated. When the interrupt mask allows the interrupt, 
the program that is currently executing is stopped, its 
registers and overflow states are stored in the interrupt 
stack, and control is given to the interrupt response 
routine, which enters the driver's continuator entry point. 
The driver acknowledges the interrupt and performs the 
I/O command or, if the request is complete, the complete 
request routine is called, followed by a jump to the 
initiator. 

If there is a hardware malfunction and the device fails to 
give an interrupt at the end of an operation, the time-out 
entry is scheduled by the diagnostic timer routine when the 
clock value in the physical device table has expired (if a 
timer is present in the system). The driver uses the MAKQ 
routine to set the error flags and then calls the device 
error logging routine. If the logical unit number is not that 
of a diagnostic logical unit, the alternate device handler 
may be called by a jump or scheduler request. If the 
request was performed on a diagnostic logical unit, the 
complete request routine is called, instead of the alternate 
device handler, followed by a jump to the initiator part of 
the driver. The diagnostic clock is set negative when a 
device is inactive. 



QUEUEING OF I/O REQUESTS 

Input/output requests are queued by logical unit number. 
Requests for the same logical unit are queued on a thread 
in the third word of the parameter list. This word contains 
the first word address of the parameter list of the next 
request (zero for unqueued requests). The beginning of 
each queue is identified by an entry in the table of logical 
units (L0G2) which contains the address of the first word 
of the first request parameter list. The end of the queue is 
identified by FFFFig in the third word of the parameter 
list for the last request in the queue. 



READ/FREAD/WRITE/FWRITE 
REQUESTS 



READ/WRITE instructions transfer data between the 
specified input/output device and memory. The word count 
specified in the request determines the end of the transfer. 

FREAD/FWRITE requests read/write records in a specific 
format for each device. 

The macro format for READ/WRITE/FREAD/FWRITE 
requests (1,2,4,6) is shown below: 

READ,rc=l 



>■ lu,c,s,n,m,rp,cp,a,x,d 



FREAD,rc=4 

WRITE,rc=2 

FWRITE,rc=6 

Where: 

lu is the logical unit. 

c is the completion address. 

8 is the starting address. 

n is the number of words to transfer. 

m is the mode. 

rp is the request priority. 

cp is the completion priority. 

a is the absolute/indirect indicator for the logical 
unit. 

X is the relative/indirect indicator (affects 
parameters c, s, and n). 

d is the part 1 request indicator (absolute 
parameter addresses). 

A detailed description of each of the above parameters 
follows after the calling sequence generated by the macro. 
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The calling sequence generated by the macro is as follows: 



IS 14 13 12 11 10 9 8 7 



4 3 





RTJ-(SF4) 1 








d 


re 


X 


rp 


.. 1 


1 




1 


2 


THREAD 1 


3 


V 


m 


a 


1 


4 


n 


5 


s 



The field descriptions for the calling sequence generated 
by READ/WRITE macros are: 

re The request code 

thread The thread location used to point to the next 
entry of the threaded list 

V The error code passed to the completion 

address in bits 13 through 13 of the Q 
register and set in the request by the system 
at completion 

Detailed parameter descriptions for the requests are: 

lu is the logical unit; an index to the LOGIA table 
of physical device table addresses that may 
be modified by parameter a. 

c is the completion address of the memory 
location to which control is transferred when 
an I/O operation is completed. If omitted, no 
completion routine is scheduled and control is 
returned to the interrupted program. The 
notation (c) represents an index to the system 
library directory, indicating the program to 
be executed upon completion of the 
requested I/O operation. Use of the (c) 
option by unprotected programs results in job 
termination. 

Completion routines are operated by 
threading the I/O requests on the scheduler 
thread. A three-bit code in the v field of the 
fourth word of the request indicates 
completion status: 

15 14 13 Description 

Q No error condition detected by 
driver; number of words is 
requested read or vt/ritten; 
device not ready 

1 No error; requested number of 
words read or written; device 
ready 

1 No error condition detected by 
driver; fewer words read than 
requested; device not ready 



15 14 13 Description 

1 1 No error; fewer words read 
than requested; device ready 

10 Error condition; requested 
words read; device not ready 

10 1 Error condition and/or end-of- 

tape detected by driver; 
number of words requested is 
read or written; device ready 

110 Error condition and/or end-of- 
file detected; fewer words read 
than requested; device not ready 

111 Error condition and/or end-of- 
file or end-of-tape detected; 
fewer words read than 
requested; device ready 

When control is returned to the completion 
address, these bits are set in similar positions 
in the Q register. If less than n words were 
transferred on a read, the location following 
the last word filled is placed in the last word 
of the user's buffer. 

An end-of-file can be verified by checking bit 

11 of word 12 in the physical device table. 



the starting address; the address of the first 
block location to be transferred (see 
parameter x). 



n is the number of words to be transferred. 

(n) Number of words to be transferred is 
determined by parameter x. 

The minimum information is transferred 
(one word or one character), depending 
on the device. 



NOTE 

For FREAD and FWRITE, n cannot be 
zero. Some devices signal zero words as 
an illegal request. 



m is the mode; it determines the operating 
condition (binary/ASCII) of a driver. 

Macro 

A Data is converted from ASCII to 
external form for output; from external 
form to ASCn for input. 

B Data is transferred as it appears in core 
or on an I/O device. 

Coding 

Binary 

1 Ascn 



1-2 
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rp IS 



q3 IS 



the request priority (15 through 0, with as 
the lowest) with respect to other requests for 
this device. This request establishes the 
order in the I/O device queue. It is 
automatically zero for unprotected requests. 

the completion priority (15 through 0), the 
level at which the sequence of the code 
specified by parameter c is executed. It is 
automatically 1 for unprotected requests. 

the absolute/indirect indicator for the logical 
unit. 



Macro 



blank 



R 



I 



The first parameter (lu) specifies 
the logical unit. 

lu is a signed increment (-lFFj5< 
lu<lFFj^g) which is added to the 
address of the first word of the 
parameter list to obtain the core 
locaton containing the logical unit 
number. 

lu is the address of the core location 
number (lu < 3FFj^g). 



Coding 

lu is a logical unit number. 

1 lu is a signed increment C+lF^F'j^g); 
not allowed if d = 1. 

2 lu is a core address containing the 
logical unit number. 

the relative/indirect indicator; this 
parameter affects parameters c, s, and n as 
shown here. Because of the wrap-around 
feature, computed addresses may be before 
or after the parameter list. 



(c) is indirect 



or blank and 
c is direct 

or blank and 
s is direct 



or blank and 
(s) is indirect 



T^ or not 
blank and c is 
direct 



X is meaningless and (c) 
represents an index to the 
system directory. 

c is the completion address. 



s is the starting address. If 
the request is on mass 
memory, the mass memory 
address follows the request. 

(s) is a memory location 
that contains the starting 
address. If the request is 
on mass memory, the mass 
memory address follows 
the memory location that 
contains the starting 
address.t 

c is a positive increment 
that is added to the address 
of the first word of the 
parameter list to form the 
completion address. 



T^O or not 
blank and s 
is direct 



^0 or not 
blank and (s) 
is indirect 



s is a positive increment 
added to the address of the 
first word of the 
parameter list to form the 
starting address. If the 
request is on mass 
memory, the mass memory 
address follows the request. 

(s) is a positive increment 
added to the address of the 
parameter list to form the 
address of a location 
containing another positive 
increment. If the request 
is on mass memory, the 
location containing the 
second increment is 
immediately followed by 
two words which contain 
the mass memory address. 

x is meaningless and n is 
the length of the block to 
be transferred. 

(n) the memory location 
containing the block size 

(n) is a positive increment 
added to the address of the 
first word of the 
parameter list to obtain 
the location containing the 
block size. 



d is the part 1 request indicator; this parameter 
indicates that the request requires the use of 
16-bit address arithmetic. 



n is direct 



X is or blank 
and (n) is 
indirect 

X is ?^ Q or 
;^ blank and 
(n) is indirect 



or blank Preceding description 

parameter applies 



of 



X is ignored. 

n is the number of words 

c and s are 16-bit absolute 
addresses. 



lu 



Mass Memory Address Format: 
151 14 



is processed the same 
as d = 0. 

cannot be set to R. 



MOST SIGNIFICANT BITS OF MASS 
STORAGE ADDRESS (MSB) 



LEAST SIGNIFICANT BITS OF MASS 
STORAGE ADDRESS (LSB) 



(LSB) 



The mass storage address specifies that a mass memory 
word address (READAVRITE) or a mass memory sector 
address (FREAD/FWRITE) return is to the location 
following the mass storage address. 



t 



If bit 15 is set for (n) or (s), incrementing continues indirect until bit 15 is not set. 
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MOTION 

This request (14) is used to control motion and end-of-file 
processing. The macro format is: 

MOTION lu,c,pi,p2,P3idy,rp,cp,a,x,d,m 



Where: 



lu is the logical unit. 



c is the completion address. 



The MOTION control request code is 14. The calling 
sequence generated by the macro is: 



15 


14 


13 


12 


11 10 


9 


8 


7 


4 


3 







RTJ-($F4) 1 





d 


re 


X 


rp 


CP 1 


c 


THREAD 


V 


m 


a 


1 


pi 


P2 


P3 


-V 



p^, are the motion control parameters; each of 
P2) these results in a specific action. Up to 

P3, three motion commands may be defined in 

a MOTION request; they are executed in 
the sequence PifP2>P3« The first 
command with a value of zero terminates 
the request. Available motion request 
code meanings vary with the device. 



dy 


is 


the density parameter. 






No change 








1 800 bpi 








2 536 bpi 

3 200 bpi 


External rejects result 
when an illegal density 
selection is attempted.' 






4 1600 bpi 




rp 


is 


the request priority. 


cp 


is 


the completion 


priority. 



is the absolute/indirect indicator for the 
logical unit. 

is only related to the completion address. 



is set to 



All parameters are 
processed as described 

1 A part 1 request is 
indicated (c is a 16-bit 
absolute address and 
must not equal R for 
the a parameter). 



is the mode. 
A ASCn 
B Binary 



Where: 
re 



is the request code. 



thread is the thread location used to point to the 
next entry on the threaded list. 

V is the error code setting. 

One MOTION control can be repeated for magnetic tape. 
In this case the macro request is as follows: 

MOTION lu,c,r,p,n,0,rp,cp,a,x,d,m 

Wiere: 

r is the repeat function indicator that must equal 
R in the a parameter. 

p is the motion code. 

n is the number of times to be executed, not to 
exceed 4,095. 

is a null parameter. 

All of the parameters are the same as in the preceding 
MOTION request except for r, p, n, and 0, that replace 
Pl>P2»P3» and dy. 

The coding sequence generated is the same as above except 
for the last word, which is generated as follows: 



15 14 12 11 



In n 



In addition to the attempt to set a density that is not legal 
allow a density change if the unit is not at load point. 



\Miere 1 indicates that the request can be repeated, 
for a unit (for example, 200/556 bpi on an 1860), the drivers do not 



1-4 
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The following macros can also be used for MOTION 
requests; each macro can perform only one type of motion. 

BSR* lu,a,n,c,p (Code 1) 

EOF* lu,a,n,c,p (Code 2) 

REW* iu,a,n,c,p (Code 3) 

UNL* lu,a,n,c,p (Code A) 

ADF* lu,a,n,c,p (Code 5) 

BSF* iu,a,n,c,p (Code 6) 



ADR* lu,a,n,c,p (Code 7) 



Where: 



* specifies a relative completion address. If 

left blank, there is absolute completion. (The 
macro computes the relative address constant.) 

lu is the logical unit number of the device. 

a is the absolute/indirect/relative indicator for 
the logical unit. 

blanl< lu is the actual logical unit number. 

R lu is a signed increment 

(-lFFi6<lu<lFFi6) added to 
the address of the first word address 
of the parameter list to obtain the 
address of a location containing the 
actual logical unit number. 

I lu is a core address (0 to 3FFj;g) 

that contains the logical unit 
number. 

n is the number of iterations. If blank, 1 is 
assumed (not to exceed 4,095). 

c is the completion address. If the macro call 
terminator is an *, completion is relative 
(only the label name is required). If the 
macro call terminator is a blank, the 
completion is absolute. If c is left blank, 
there is no completion. 



p is the priority level; it defines both the request 
and completion priority. If left blank, the 
priority is zero. 



All parameters are optional and may be left blank with the 
exception of lu. 



Examples: 

The following parameters are common to the examples: 

NEXT is the completion address. 

6 is the logical unit of the magnetic tape. 

10 is the logical unit of the card punch. 

MT is the program location containing a 6. 

FAjLg is the low core location containing the 
standard binary output device. 



1. A backspace macro with the following: A relative 
location containing the logical unit number, backspace 
3 records, a relative completion address, and a request 
and completion priority of 3. 

BSR* MT,R,3,NEXT,3 



2. Same as the above, except that the completion address 
is absolute. 

BSR MT,R,3,NEXT,3 



3. An end-of-file macro with the following: The actual 
logical unit number, write one end-of-file, zero 
completion, and a priority of 0. 



EOF 



10 



4. Same as above, except that the logical unit number is 
in a low memory location. 

EOF FAi6,I„,0 
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SYSTEfyi Si^TERFAGES FOR I/O DRi¥ERl 






Several system functions are common to most I/O drivers. 
The programs that perform the functions are resident in 
macro memory. The programs are always called with the 
address of the physical device table in the computer I 
register. The remainder of this section describes the 
functions that are performed. 



FIND-MEXT-REQUEST 



The find-next-request (FNR) routine is used by all driver 
initiator modules to find the next request for a device and 
to fill the physical device table with information from the 
request. I^NR is entered by an indirect return jump 
through 65^6 with the memory address of the physical 
device table entry in the I register. 



COI^PLETE REQUEST 

The complete request (COMPRQ) routine is entered by an 
indirect return jump through B6j6 from input/output 
drivers to complete requests. This causes interrupts to be 
inhibited and the completion address to be scheduled with 
the error field from the physical device table, replacing 
the error indicator (v field) of the I/O request parameter 
list for logical units that do not share devices. Q is set 
negative if an error occurs. The request parameter list 
(containing a request code designating it as an I/O call) is 
interpreted as a secondary scheduler call by setting bit 15 
of the first word to 1. The scheduler resets it to 0, and the 
device is released from its request assignment. When the 
driver has completed the request, control is given to the 
dispatcher. The dispatcher then passes control to the 
highest priority interrupted program or scheduled 
program. The latter might be the completion address if 
one was specified and is the highest priority program 
awaiting execution. 



DEVICE SHARED 

The FNR routine scans the logical unit table, starting with 
logical unit one, to locate other logical units related to the 
same device. When a logical unit with a waiting request is 
encountered, FNR initiates the input/output device in the 
same manner as unshared devices. The lowest numbered 
logical unit with a request waiting for that device has the 
highest priority; that is, the device priority completely 
supersedes the scheduling priority. Scheduling priority 
becomes operational only within the thread of requests 
when the logical unit is activiated. In other words, if two 
logical units sharing the same physical device both have 
requests queued (in priority order), all requests from the 
lower numbered logical unit are executed before the first 
request from the higher numbered logical unit starts 
processing. If no requests are waiting on a device, FNR 
exits to the caller at the address of the call plus one. 



The complete request is entered by a return jump to 
COMPRQ that terminates the request by executing the 
following: 



1. Resets the diagnostic clock counter (EDCLK) to 
FFFFi6 

2. Transfers the error field in the physical device table 
(EST ATI) to the v field of the request 

3. Clears the operation in the progress bit (EREQST) 

4. Clears the thread and returns to the driver if there is 
no completion address (C = 0) 

5. Schedules the completion address if there is one, 
passing any error condition in Q and in the v field of 
the request, and returns to the driver 



DEVICE NOT SHARED 

FNR examines the queue to obtain the next request. If 
none exists, FNR exits to the caller at the address of the 
call plus one. If another request is found, FNR updates the 
queue, fills the physical device table, and returns to the 
caller at the address of the call plus two. Upon return, the 
I register is unchanged and the A, Q, and overflow registers 
are destroyed. 



SET ERROR FLAG 

The MAKQ routine is used by the drivers to set up the v 
field of the logical unit word of the request and to place 
the address of the last valid data into the last word of the 
caller's buffer. 
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DIAGNOSTIC TIMER MODULE 

Initially, the diagnostic timer is operated after system 
start-up. Thereafter, it is periodically reactivated by a 
TIMER request. The frequency of operation is dependent 
on a parameter internal to the diagnostic timer program 
(normally one second). 

An input/output hang-up error occurs when a driver fails to 
get a completion interrrupt on an operation that it 
initiated. The diagnostic timer module detects hang-ups. 
The following features must be available for proper 
operation of the diagnostic timer module or these errors 
cannot be detected. 

• A hardware device that gives periodic interrupts to 
measure time 

• The timer request module 

• The diagnostic timer module 



The driver establishes a time differential (in increments of 
seconds) for each input/output operation; upon differential 
expiration a hang-up is assumed. This differential is 
entered in the physical device table slot for the device. 
The diagnostic timer then decrements the time differential 
each time the module is set into execution. When the 
differential becomes negative after decrementing, a 
hang-up is assumed. If the time differential is negative 
before decrementing, either the operation is complete or 
no operation has occurred. 

When a hang-up occurs, the diagnostic timer accesses the 
physical device table entry for that device to obtain the 
driver memory location to be executed in case of a 
hang-up. This location is executed by a SCHDLE request 
at the same priority level as the driver. Q contains the 
memory address of the physical device table entry for the 
device. The driver takes any necessary action to clear the 
device involved in the hang-up. If recovery is not possible, 
it transfers control to the alternate device handler. The 
parameters passed are the logical unit number and error 
code. 

The devices to be supervised by the diagnostic timer are 
specified by a table of physical device table addresses. 
This table (DGNTAB) is included in the SYSDAT program. 



ALTERNATE DEVICE HANDLER 

When a driver detects an irrecoverable failure of an 
associated device, the following actions tal<e place: 

1. The driver sets the error field in bits 15 through 13 at 
word 9 (EST ATI) of the physical device table. 



2. The controller hardware is cleared and an error word 
is set in the Q register. 



15 




6 


5 





LOGICAL UNIT 


ERROR CODE 



3. The driver transfers control to the alternate device 
handler by a jump or a scheduler request with the 
error word in the Q register. 

The following are typical errors: 

Input/output hang-up (diagnostic timer) 

Alarm 

Parity error 

Checksum error 

Internal reject 

External reject 

The alternate device handler determines if the device has 
an operational alternate; if so, the request for the device 
that failed is assigned to it at the priority level of the 
driver operating the device that failed. The logical unit 
that failed is marked down, and the alternate is set active 
(bit 13 of LOGl is set). The request Is then rethreaded to 
the alternate logical unit. If no alternate exists, the 
program reschedules itself at a low priority level to 
request operator intervention. In either case, all message 
output Is executed from a low priority level section of the 
program. 

The alternate device handler continues to assign alternates 
to devices that failed without waiting for completion of 
input/output messages. Therefore, the buffer table 
(ALTERR) must be provided to store the error words on 
entry. This table is included in SYSDAT. The size of the 
table is included in the first location of the table and is 
equal to the number of devices that can malfunction at one 
time. If this table size is not adequate for the system, the 
ADEV program hangs (18FF) when the table is filled. 
Identical device failures are not accumulated in the error 
table. 

If the alternate is also inoperative and it does not specify 
an alternate, the procedure is the same as if no alternate 
were available for the original unit and is repeated until an 
operative alternate is found or until the handler determines 
that one is not available. 
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Wfrien an operative alternate Is found, pointers are set so 
that requests from the failed device are . automatically 
transferred to the alternate. The comment device has the 
following format: 

L,lu FAILED ec 

ALT, aa 

Where: 

lu is the logical unit number of the failed device. 

ec is the error code. 

aa is the' logical unit number of the alternate. 

If no alternate is found, the handler issues the following 
diagnostic: 

L,lu FAILED ec 

ACTION 

Where: 

lu is the logical unit number of the failed device. 

ec is the error code. 

The operator must respond to the error with one of the 
following and then press RETURN. 

RP Directs the request to repeat 

CU Reports the error to the requesting program; the 
device is allowed to continue processing requests. 

CD Causes any future programs calling the device to 
be informed of the failure upon completion; the 
error is reported to the calling program and the 
device is marked down. No subsequent attempt is 
made to operate this device. The message 

LU XX DOWN 

is printed on the comment device only the first 
time the device is accessed after CD has been 
entered. 

DU Activates CU and terminates the current job 
being processed; the input unit attempts to slew 
to the next job to be executed. 

DD Activates CD and terminates the current job 
being processed; the input unit attempts to slew 
to the next job to be executed. 

If job processing is not in progress when the DU and DD 
options are selected, no action is taken, the word ACTION 
is retyped, and another option may be selected. 

Mass storage device drivers do not use the alternate device 
handler. Mass storage device errors are logged in the 
engineering file. 



The comment device must never be marked down because 
it is required to bring devices back up once they are 
operational. The dummy device driver, acting as an 
alternate for the comment device, restores the downed 
comment device. 

The completion address is always scheduled with an error. 
The requesting program should not repeatedly request 
downed units. 



MASS-STORAGE RESIDENT 
DRIVERS 



Most drivers are capable of functioning as either main- or 
mass-memory resident drivers. The following device types 
are not considered to be good candidates for mass-storage 
residency. 



display terminal 



O Teletypewriters/conversational 
keyboard drivers 

O Mass storage devices 

• Software buffer 



9 Dummy 

All mass-storage resident drivers execute in a shared fixed 
buffer area located in SYSDAT. The allocation of this 
buffer is controlled by a main memory-resident executive 
routine, MMEXEC. It is possible to load either one or two 
drivers in the buffer, depending on its size. 

The main memory buffer should be at least as large as the 
largest driver that is used in the system. The maximum 
size required that allows two drivers in memory 
simultaneously is the combined size of the two largest 
drivers in the system. Whenever the DCOSY driver is used 
in a system, the maximum size criterion (the two largest 
drivers) should be used since DCOSY makes I/O requests 
upon another driver that has to be in memory at the same 
time to complete the request for the COSY driver. This is 
also true when using print spoolers, batch input/output 
drivers, and (in some cases) magnetic tape simulator 
devices. 

When a driver is mass-memory resident, the driver's 
physical device tables must declare their initiator, 
continuator, and time-out entry addresses to be the 
corresponding entries in MMEXEC (that is, MASDRV, 
MASCON, and MASERR). 

When an I/O request is made upon a mass-memory resident 
driver, control is routed to the entry point MASDRV. 
MASDRV determines if the driver is already in memory 
and passes control to it. If the driver is not in memory, it 
is determined if there is sufficient memory available in the 
buffer for the new driver. If so, the driver is read in from 
mass memory and placed in execution. When there is not 
sufficient memory for the driver, it is queued for later 
execution when space is released lay drivers that currently 
occupy the buffer. 
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When a driver completes its input/output for all of the 
devices it controls, it releases its space in the memory 
buffer by jumping to MASEXT. At this time MMEXEC 
resets all initiator, continuator, and time-out addresses for 
this driver's physical device tables to point to the 
corresponding entries in MMEXEC. If any other drivers are 
waiting in the queue, the first one encountered is read 
from mass memory and placed in execution. 

When MMEXEC enters a driver, the Q register contains the 
physical device table address and the A register contains 
the first word address of the driver. 

The mass memory location and size of each mass-memory 
driver must be contained in words 13 and 14 of the physical 
device table. These parameters are supplied by *S 
initializer control statements during system installation. If 
a driver is memory resident, its mass memory size must be 
set to zero and its length to VFFFjg. This is not 
required for mass memory device drivers such as disk or 
drum. 



INTERRUPT RESPONSE ROUTINES 



Individual interrupt processing routines are used for 
interrupt lines that are assigned to only one controller. 
These routines usually consist of setting Q to the address 
of the physical device table for that device and then 
transferring control to the driver continuator. 



Example: 
R17331 



LDQ 
JMP* 



=XP73310 
(P73310+2) 



The address of the interrupt response routine (R17331) is 
contained in word 3 of the interrupt trap for the interrupt 
line. 

If several devices are assigned to one controller, the 
interrupt processor must identify the device (usually by 
reading the status on each device) that interrupted. For 
some special devices, the interrupt processing routine is an 
integral part of the driver. The address in word 3 of the 
trap is then set to the address of the processor for this 
specific interrupt. 



ENGINEERING FILE LOGGING 

All hardware failures detected by the I/O drivers are 
logged in the engineering file by the program log. The 
logical unit and error code are defined in the Q register 
(see alternate device handler). The call is: 

RTJ+ LOG 



A/Q CHANNEL ALLOCATION 

The CYBER 18 computer input/output is an unbuffered 
operation performed via the A/Q channel. For devices 
where the data is contained on transportable media such as 
cards, paper tape, and magnetic tape and where the 
controller does not buffer the data, data can be lost if 
inadequate response time is provided to service a data 
interrupt. To avoid lost data, the drivers of these devices 
must run at a higher priority than the system hardware 
timer. 

The following types of devices are subject to this data 
handling restriction: 

O Paper tape reader 

• Paper tape punch 

• Card reader 

• Card punch 

• Unbuffered magnetic tape 

• Keyboard/conversational display terminal 

The A/Q channel allocator (ALAQ) program is provided to 
allocate the A/Q channel if more than one of these devices 
is present in a system. 



AUTO-DATA TRANSFER (ADT) 

Auto-data transfer (ADT) provides pseudo direct memory 
transfers of data blocks to or from a device. At the macro 
level, the transfer appears as a direct memory/storage 
access (DMA/DSA) transfer; however, at the micro level, 
the 1700 emulator processes each data interrupt and inputs 
or outputs the next word of data in a singular fashion. 
ADT takes less time than input/output via the INP, OUT, 
or SIO instructions, but more time than a true DMA/DSA 
transfer. 

To use ADT for a particular device: 

O The device and its controller must be capable of 
operating in the ADT mode and must adhere to the 
ADT specifications. 

• The macro programmer must execute a DMI 
instruction (which specifies the location of the ADT 
table). Information in the ADT table specifies the 
beginning and end of the data block in main memory, 
the direction (input or output) of data flow, the 
equipment code (address) for selecting the device, and 
wliether the data transfer is a word (16 bits) or a 
character (eight bits). 

• The ADT operation must be initiated by an OUT (or 
SIO) instruction as specified by the particular device. 
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While the ADT operation is in progress, the emulator is 
executing macro instructions. However, after each macro 
instruction is executed, interrupts are checl<ed. If the 
particular ADT micro interrupt has become the highest 
active interrupt, the next data word is input or output. 
After the interruption, the next macro instruction is 
executed unless there is another interrupt active. 

When the ADT operation is completed (or if there is an 
error), a macro interrupt is generated. The macro 
programmer may then disable the ADT micro interrupt or 
initiate another ADT operation to or from the device. 
Note that for M05 devices, an SPS instruction must be 
done to clear the macro interrupt. 

Four types of ADT tables are specified by DMI 
instructions. They are described in the following sections. 



ADT TABLE FOR SINGLE A/Q DEVICE 

The ADT table for a single A/Q device is as follows: 



15 14 13 12 11 10 



7 6 



M^^ 



S/D 



CWA 



LWA 



NOT USED 



CWA is current word address counter during the 
ADT operation (which always points to 
the last data word read from or stored 
into main memory). During a data 
transfer, the emulator increments the 
current word address counter before the 
data is transferred. Therefore, it is 
necessary for the macro programmer to 
initially set word 2 of the ADT table to 
the first word address minus 1 of the 
data block in order for the transfer to 
occur correctly. Word 2 is used in 
conjunction with word 3 (by the macro 
programmer) to ascertain if all data 
(words or an even number of characters) 
was transferred after the ADT operation 
is completed. (If the current word 
address equals the last word address 
when the software driver is recalled with 
a macro interrupt, all data was 
transferred.) In character mode, word 2 
in the ADT table is not actually updated 
until the second character has been 
transferred. 

LWA is last word address of the data block to be 
transferred. 



ADT TABLE FOR MULTIPLE A/Q DEVICES 

The ADT table for multiple A/Q devices is shown in 
figure 2-1: 



The ADT table for a single A/Q device consists of four 
words: 



Where: 
w/c 



is type of operation 

Word operation. For a word operation, 
data is transferred one word at a time. 
Normally a total of (CWA-FWA+1) words 
are transferred. 

1 Character operation. For a character 
operation, data is transferred eight bits 
at a time. The first character is stored 
in the most significant half (bits 8 
through 15) of the current word address; 
the second character in the least 
significant half (bits through 7). 
Subsequent pairs of characters are input 
in the same fashion. Normally a total of 
2*(CWA-I^A+1 characters are 
transferred. 



r/w is read/write 

Read 

1 Write 



IM+1 
I •4+2 
1*4+3 
IM+4 

2465 



IS 


14 


13 


12 


11 


10 


9 


8 


7 


6 


S 


4 


3 


2 


1 








1 











E 


NOT USED 


1 





Tl5 


^14 


^13 


^12 


^11 


^10 


Tg 


^8 


^7 


^6 


T5 


u 


T3 


^2 


^1 


To 


^31 


T3O 


^25 


^28 


^27 


^26 


^25 


^24 


^23 


^22 


T2I 


T20 


^19 


^18 


^17 


^16 


NOT USED 1 





1 


/ c 





X 


E 


S/D 


CWA 


LWA 


NOT USED 



S/D 



CWA 



LWA 



NOT USED 



E is equipment number of the device. (It cannot 
conflict with any M05 I/O port numbers.) 

S/D is station/director bits of the device. 

Director bits should specify a data (not a 
status/function) transfer. 



Figure 2-1. ADT Table For Multiple A/Q Devices 
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The ADT table for this type consists of 1*4+4 words, where 
I is the number of multiple A/Q devices (up to 32) on the 
micro interrupt. 



Where: 

E 



Words 5 
through 8 



is equipment number of the device. (It 
cannot conflict with any M05 I/O port 
numbers.) 

is termination bits for the 32 devices. 
Initially, they must be all zero. When 
a macro interrupt occurs (after 
RTERM is generated), one or more of 
these bits is set to indicate that one or 
more ADT operations have 

terminated. Thus T7 = 1 indicates 
that station (or channel) number 7 has 
terminated its ADT operation. After 
receipt, the bit should be cleared via 
an instruction that locks memory (for 
example, a CLF instruction). 

same as words 1 through 4 of a single 
A/Q device except bit 14 of the first 
word must be 1. (Words 1*4+1, 1*4+2, 
1*4+3, and 1*4+4 are defined in the 
same way.) 



ADT TABLE FOR CLOCK 

The ADT table for clock is as follows: 





15 


14 


13 


12 


11 


10 


7 


6 







1 


1 














E 


S/D' 1 


2 


CC 


3 


CL 


4 


NOT USED 



The ADT table for this type consists of four words: 

Where: 

E is equipment number of the clock (always 
equal to 1) 

S/D is station/director bits of the clock (always 
equal to 70ig. (Thus, word 1 should equal 
8OFO16.) 

CC is clock counters initially set to zero. 
Whenever the clock has been enabled, the 
clock counter is incremented every 3-1/3 
milliseconds. 

cl is clock limit, which is interpreted as a 
multiple of 3-1/3 milliseconds. When the 
clock counter equals the clock limit and the 
macro clock interrupt is enabled, the macro 
interrupt occurs. (If the clock limit is five, 
the clock interrupt interval is 16-2/3 
milliseconds or 60 times a second.) To 
continue the process, the clock counter 
should be reset to zero, or the limit counter 
incremented by its original value (five). In 
this later method, the clock counter can 
function as an elapsed time counter. 



ADT TABLE FOR SINGLE OR MULTIPLE 
M05 DEVICES 

The ADT table for single or multiple M05 devices consists 
of (I-l)*4+4 words, where I is the number of MG5 devices, 
up to 8, on one micro interrupt. The ADT table is shown in 
figure 2-2. 



15 14 


13 


12 


11 10 


9 7 


6 


5 


4 2 


1 





Jil 


X°X!^ 


PORT 








NOT USED 





»1 


CWA 


LWA 


NOT USED 



(l-1)M+1 


1 





'A 





y^ 


1 


PORT 








NOT USED 





»1 


(1-1 1*4+2 


CWA 


(l-1)M+3 


LWA 


{l-1)M+« 


NOT USED 



2466 



Figure 2-2. ADT Table for Single or 
Multiple M05 Devices 



Where: 

w/c is same as for single A/Q device 
r/w is read/ write 

Read 

1 Write 

port is port number of the device, where bit 10 is 
always 1. Port numbers are analogous to 
the A/Q I/O equipment numbers and cannot 
conflict with them. 

CWA is current word address. Initially set to the 
first word address minus 1 of the data block 
to be transferred. This is the current word 
address while the ADT operation is in 
progress and points to the last data word 
read/stored. Each time a word (or two 
characters, if character operation) is 
transferred, the current word address is 
incremented. The current word address can 
be used to ascertain if all the data was 
transferred after the ADT operation is 
completed (that is, if the current word 
address equals the last word address, all 
data has been transferred). 

LWA is last word address of the data block to be 
transferred 

Wards (I-l)*4+4, (I-l)»4+2, (I-l)*4+3, and (I-l)*4+4 (where 2 
< I < 8) are defined the same as words 1, 2, 3, and 4, 
respectively. 
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FOR KEYBOARD AND TERMINAL DRIVERS 



ia>»aie«m..a»ar^T.gtg:;ic-aifeByaii»ai»?^.^^^^^^ 



MSOS 5 1811/722 CONSOLE 
DISPLAY 



Four types of requests, READ, WRITE, FREAD, and 
FWRITE, are honored from the keyboard. Each request 
specifies the memory starting address location being read 
into or written from, the number of words, and the 
completion address. All data is in ASCII format. 



WRITE 

The specified number of words is printed starting at the 
specified memory location. Each word causes two 
characters to be printed with the upper half being printed 
first. If zero number of words is specified, only one 
character is printed from the upper half of the specified 
memory location. If an ASCII end-of-text character 
(03]^g) is encountered, the request is terminated at that 
point, regardless of the number of words specified. 



READ 

The number of words specified by the READ request is 
filled, starting at the specified memory location. Two 
characters fill one word; the first character is put into the 
upper half of the word. Bit 7 of each character is an even 
parity bit; it is set to zero after it is checked and before it 
is packed. If the parity bit is incorrect, a hardware error is 
indicated. 

If zero words are specified, only one character is read into 
the upper half of the specified memory location. The 
lower character is filled with a hexadecimal FF. 



15 14 



8 7 6 






FIRST CHARACTER 





SECOND CHARACTER 



UPPER HALF 



LOWER HALF 



FREAD 

Words in memory are filled, starting at the specified 
memory location and continuing until the number of words 
specified is filled or a carriage return is encountered. Two 
characters are packed in each word. Bit 7 of each 
character is interpreted as an even parity bit before being 
cleared to zero. Line feed characters are ignored. If a 
cancel character is encountered, characters are passed and 
no information is stored until a carriage return is detected. 

The request is then repeated from the beginning. If a 
carriage return Is not encountered before the specified 
number of characters is read, characters are passed until a 
carriage return is detected. A carriage return before the 
specified number of words is read constitutes a short read. 



FWRITE 

This operation is the same as WRITE except that before any 
words are printed, a carriage return and line feed function 
are executed by the teletypewriter driver. 



MOTION 

A write end-of-file MOTION request (code 2) to the 
keyboard is honored by executing a top-of-form function. 
All other MOTION requests cause no action with normal 
completion of the request. 

ITOS 2/COS^^ 18 1843-1 DUAL 
CHANNEL COMMUNICATION 
LINE ADAPTER 

The driver supports simultaneous transmission/ reception 
on one or both of the channels of a DC CLA and multiple 
DC CLAs. Data transmission and reception is performed 
using the ADT mode of data transfer. Being a generalized 
synchronous driver, the transmission odd or even parity, 
data bit length, synchronization character code, and so 
forth, is specified by issuing an initialization function prior 
to performing data communications on the channel. 

Each channel of each DC CLA is assigned a logical unit 
number. 

Once the channel has been initialized, data blocks can be 
transmitted by issuing standard monitor \M^ITE/FWRITE 
requests to the appropriate logical unit. READ/FREAD 
monitor requests are illegal and are rejected by the driver. 

MOTION requests are used to initialize and/or control 
channel functions. 

All detected hardware errors are logged in the system 
engineering file without any messages on the console CRT 
(does not use the alternate device handler). Error status is 
passed to the applications program in request completion 
address in the V -field of the Q-register and in the monitor 
request for WIITE/FWRITE and magnetic tape motion 
requests only. 
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WRITE/FWRITE 

Standard monitor WRITE/FWRITE requests are used to 
transmit data blocks. Both types of requests are handled 
identically. The mode bit is ignored. 



NOTE 

All leading sync characters, control 
characters, CRC, and PADs must be 
supplied in the user's data buffer. To 
ensure transmission of the complete data 
block, two extra PAD characters should 
be placed at the end of the user's data 
buffer. The data buffer is to be packed 
two characters (bytes) per word, the 
leftmost byte being transmitted first. 
The buffer must contain an even number 
of bytes since the length of the 
transmission block is given in number of 
words. 



Once the transmission has been initiated, a timeout period 
of 10 seconds is set. This timeout period is cleared upon 
completion of the transmission. If an error or output 
timeout occurs during data transmission, a return is made 
to the completion address of the applications program with 
the error V -field set as follows: 



Ward 4 of the request contains the absolute address of a 
six-word initialization table in the calling program of the 
following format: 



Word 

1 
2 

3 

4 



Contents 
Transmitter control word 
Receiver control word 



Transmitter 
character 



fill/receiver synchronous 



Indicates an error has occurred 

Indicates a short transfer 

If carrier on during transmission 

If carrier turned off during 
transmission 



Bit 15 = 1 
Bit 14 = 1 
Bit 13 = 1 
Bit 13 = 

READ/FREAD 



All READ/FREAD requests are rejected and return is made 
to the user's program completion address with the error 
V -field set to 100 binary. 



MOTION 

Standard MOTION requests are accepted by the driver. 
Channel initialization or control functions are govered by 
the mode bit (word 3, bit 12) of the request. 



Mode Bit = 1 

This request is used to initialize the channel prior to data 
communications. 



PAD character format 

ADDR of user PGM for input character 
handling 

Priority for schedule of user PGM address 



NOTE 

The transmitter fill character and 
receiver sync character are assumed by 
the driver to have the same format. 



This function will cause the channel to be initialized as 
specified, data terminal ready will be set, and the channel 
will be placed in search sync mode waiting for data 
reception. 



Mode Bit=0 

These types of requests are used to control certain 
functions of the data channel. The type of control function 
performed is governed by the value of bits 14 to 12 of the 
motion type word (word 4) in the request. The other bits in 
this word are ignored. Only one channel function is 
handled per request. 



Word Action 

Request is rejected 

1 Request is rejected 

2 Set data terminal READY/RESYNC - Data 
terminal ready status is set, all error 
conditions are cleared, and receiver is placed 
in search sync mode. This control function is 
used to reconnect the line after type 3 
control (clear data terminal ready) or type 5 
control (stop intput of characters). 
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Action 

Clear data terminal ready - I/O interrupts 
and data terminal ready status are cleared. 
This control function is used to disconnect a 
line on a switched networi<. 

Release communications line - The channel 
is cleared, data terminal not ready, and user 
program address in PHYSTB is cleared. This 
frees the channel for use by another 
applications program. 

Stop input of characters - The user program 
address in the PHYSTB is cleared, and search 
sync bit in channel function word is cleared 
stopping the reception of any further 
characters. The input of characters is 
automatically restored after a 

WRITE/FWRITE request or MOTION request 
type 2. 

Request is rejected 

Request is rejected 



DATA RECEPTION 

Once initialized, the channel is ready to receive input 
data. After transmitting a data block, the channel is 
automatically placed back into receive mode. 

The driver waits until synchronization has been established 
and until all leading sync characters have been received 
before passing data to the user program. 

Once synchronization has been established, the first 
non-sync character sets a timeout period of 10 seconds. 
This timeout period is cleared by the reception of a PAD 
character. Alternatively, any monitor request to the 
driver will clear the timeout condition. If an input timeout 
occurs, the channel is placed back into search sync mode to 
attempt to resynchronize on the next data block received. 
Bit 10 of PHYSTB word 9 (EST ATI) is used as a flag to 
indicate an input timeout is in progress. 

The first non-sync character and all following characters 
(including control, sync, CRC, and PADS) are passed to the 
user's program by scheduling the address at the priority 
specified in the initialization table. Passed to the user's 
program is the Q-register set as follows: 



Bits to 7 



= Data character 



Bits 8 to 14 = Logical unit of channel 



NOTE 

If the priority for the schedule of the 
user's address during channel 

initialization is zero, the user's program 
is entered by a jump at driver priority 
instead of the schedule. It is essential 
that the user's PGM give 141 control 
(jump to the dispatcher) as quickly as 
possible or lost data conditions will 
occur. 



DC CLA Channel Status Bit Definitions 
Obtained by input with Q-register, D = 001 
Bit Definition 

Ready 

1 Busy 

2 Input data interrupt/data ready 

3 Output data interrupt/data request 

4 Receive error interrupt 

3 Auto data transfer on input 

6 Auto data transfer on output 

7 SYNCl match 

8 Carrier on 

9 Clear to send 

10 Ring indicator 

11 Data set ready 

12 Data not available 

13 Auto data transfer EOP (both channels) 

14 Program protect 

15 Test mode 

DC CLA Channel Function Bit Definitions 
Output to channel with Q-register, D = 001 

Bit Definition 

Clear channel 

1 Clear input interrupt 

2 Clear output interrupt 

3 Enable input interrupt 

4 Enable output interrupt 

5 Enable receive error interrupt 

6 Set receive auto data transfer 

7 Set transmit auto data transfer 

8 Set data terminal ready 

9 Set request to send 

10 Not used 

11 Clear auto data transfer EOP 

12 Reset data not available 
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Bit 
13 
14 
15 



Definition 



Reset receive error 
Set search sync mode 
Set test mode 



DC CLA Input Data Transfer Bit Definitions 
Obtained by input with Q-register, D = 000 



Bits 



Definition 



0-7 Data character 

8 Not used 

9 Parity error 
10-12 Not used 

13 Lost data 

14 Character request 
13 Not used 



REQUEST FORMAT 

The MSOS monitor requests specified by the executive are 
standard, except for the following: 

• Request mode bit A specifies the data element of the 
request. All requests are ASCII, either character- or 
word-oriented: 

A = indicates that the request length 
specifies characters. 

A = 1 indicates that the request length 
specifies words. 

• All communications terminals are defined as a single 
logical unit in MSOS. The individual communications 
line is specified by a logical port number contained in 
the message header. 

• The Q-register contains the V -field and the logical 
port number at the completion of an I/O request. 

• The monitor request is nine words in length: word 6 
contains a control point indicator (bit 15 = 1), word 7 
contains the address of a seven-word request buffer, 
and word B contains the control point of the user's 
request. The format of the seven-word request buffer 
is as follows: 



Word Bits 



Definition 



DC CLA Output Data Transfer Bit Definitions 
Output to channel with Q-register, D = 000 
Bits Definition 



0-7 
8-15 



Data character 
Not used 



ITOS 2 1842-2 TERMINAL DRIVER 



The ITOS executive provides an interface between the user 
program and the system communications terminal I/O 
driver. 

All non-MSOS features of this interface are invisible to the 
user program, since the ITOS executive performs all 
reformatting prior to mal<ing the request. 

The executive operates all terminals in an unsolicited input 
mode. This mode of operation requires that the executive 
establish a logical connection with the communications 
terminals prior to any driver requests. Once this 
connection is made, all input received on the port is placed 
in the specified input buffer, and the specified completion 
address scheduled by the driver when the input termination 
character is entered. The ITOS executive does not perform 
READ or FREAD requests. When this type of request is 
received by the protect processor from a user program, it 
is translated into a WRITE OR FWRITE request with no 
completion address specified. Following the entry of data 
by the terminal user, the unsolicited input location is 
scheduled by the driver, which forms the completion of the 
user program READ request. 



15-13 Reserved for future use 
12 Completion type 

Request complete 

1 Message moved from user program 



11 



Port-active indicator 



10-0 Contain the logical port number of the 
communication line to be used. Set by 
the ITOS executive on \^ITE or 
FWRITE; set by the driver on 
unsolicited input. 

15-5 Contain the status set by the driver 
only if bit 15 of the request V -field is 
equal to one. 



15 


Communications subsystem dovirn 


14 


Transmission error 


13 


Spare 


12 


Time-out error 


11 


Illegal request 


10 


Reserved 


9 


Reserved 


8 


Spare 


7 


Spare 
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Word Bits 


Definition 


6 


Spare 


5 


Spare 


4-0 


Contain the sii)request code 



Normal mode 

1 Logical connect 

2 Logical disconnect 

3 Write-read operation 
4-31 Reserved for further use 



2 15-0 Contain the secondary device status for 

use by the communications driver 

3 15-0 Contain the termination code. Set by 

the driver on unsolicited input. 

4 15-8 Cursor X position prior to data output. 

Set by the ITOS executive. 

7-0 Cursor Y position prior to data output. 
Set by the ITOS executive. 

5 15-8 Cursor X position prior to data input. 

Set by the ITOS executive. 

7-0 Cursor Y position prior to data input. 
Set by the ITOS executive. 

6 15-0 Contain the number of characters 

requested. The driver returns the 
actual number of entered characters 
upon read completion. Set by the ITOS 
executive. 



MOTION 

All MOTION requests are ignored. 



CONNECT 

The CONNECT request is issued as a READ request and 
causes the driver to return all succeeding input to the 
buffer specified. Completion is scheduled at the address 
specified and at the priority specified. CONNECT sets 
unsolicited input mode. No completion is scheduled for a 
CONNECT request. 



DISCONNECT 

The DISCONNECT request is issued as a READ request; it 
causes the port to be disconnected from the request 
buffer. Completion is specified as in the CONNECT 
request. DISCONNECT resets the port from unsolicited 
input mode. No completion is scheduled for a 
DISCONNECT request. 



WRITE-READ 

The \M^ITE-READ request is issued as a WRITE or FWRITE 
request; it delays write completion until a succeeding 
unsolicited input is received. No read completion is 
scheduled. WRITE-READ is rejected if the port is not 
connected. An 80^5 character in the output buffer 
disables the echoing of input characters until the 
completion of the unsolicited input. 



CURSOR POSITIONING 

The driver provides cursor positioning by use of the direct 
cursor addressing of the 722/752 CRT. Two methods are 
provided: 

® A cursor positioning sequence (lB26,31i6,x,y) may 
be embedded in any write lauffer. 

O For a WRITE-READ request, word 2 of the extended 
request parameter block requests the cursor position 
that is to be used prior to receiving input data. A-1 
(FFFEjg) in word 2 disables this feature. 



READ/FREAD 

The number of characters/words specified by n are input 
into the data buffer until a termination character is 
encountered. Any characters input in excess of the buffer 
length are ignored. Any characters stored in the buffer are 
echoed to the screen unless echo is disabled (see 
WRITE-READ). Entered characters may be erased by 
means of the (bacl<space) key. Termination characters 
are not stored in the buffer. 



WRITE 

The number of characters/words specified by n are output 
to the screen. 



FWRITE 

The number of characters/words specified by n are output 
to the screen. A CARRIAGE RETURN, LINE FEED 
sequence is output before any character. A LINE FEED 
character is added following each CARRIAGE RETURN in 
the buffer. 



MSOS 5 1843-2 TER^I^AL DRIVER 



The MSOS 5.0 Terminal Driver provides communication 
with up to 16 CRT terminals. Each terminal functions as a 
separate logical unit within the MSOS system. 



REQUEST FORMAT 

The request format is standard with the addition of a 
five-word extended request parameter block as shown 
below: 



JJL 



8 7 



RESERVED 



PORT 



COMPLETION STATUS 



SUB- 
REQUEST 



RESERVED 



nb - NUMBER OF BYTES 



s - ADDRESS OF DATA BUFFER 
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Detailed parameter descriptions are: 

Reserved Reserved for future use. 
Port 



Logical port number. Set by the caller on 
READ, FREAD, WRITE, or FWRITE 
requests. 



Status/ 


Status as at the completion of the 


Sub request 


request 




Bit 


Definition 




15 


Subsystem dov^n 




14 


Line disconnect 




13 


Line down 




12 


Terminal not connected 




11 


Spare 




10 


Request timeout 




9 


Illegal request 




8 


Parity error 




7 


Break received 




6-A 


Spare 



READ/FREAD 

The number of characters specified by n are input into the 
data buffer until a termination character is encountered. 
Any characters input in excess of the buffer length are 
ignored. Any characters stored in the buffer are echoed to 
the screen unless echo is disabled (see WRITE-READ). 
Entered characters may be erased by means of the— 
(bacl<space) key. Termination characters are not stored in 
the buffer. 



WRITE 

The number of characters specified by n are output to the 
screen. 



FWRITE 

The number of characters specified by n are output to the 
screen. A CARRIAGE RETURN, LINE FEED sequence is 
output before any character. A LINE FEED character is 
added following each CARRIAGE RETURN in the buffer. 



Subrequest 3-0 code as follows: 

Bit Definition 



WRITE-READ 
Logical disconnect 
Logical connect 
Normal mode 



CONNECT 

The CONNECT request is issued as a READ request and 
causes the driver to return all succeeding input to the 
buffer specified. Completion is scheduled at the address 
specified and at the priority specified. CONNECT sets 
unsolicited input mode. No completion is scheduled for a 
CONNECT request. 



nb 



Number of bytes requested to be read for 
WRITE-READ requests set by driver to 
actual number of characters input on 
completion of READ and unsolicited input 
requests. 



Address of the data buffer for the request. 



DISCONNECT 

The DISCONNECT request is issued as a READ request; it 
causes the port to be disconnected from the request 
buffer. Completion is specified as in the CONNECT 
request. DISCONNECT resets the port from unsolicited 
input mode. No completion is scheduled for a 
DISCONNECT request. 



Seven types of requests are recognized. They are 
described below. 



MOTION 

All MOTION requests are ignored. 



WRITE-READ 

The WIITE-READ request is issued as a VRITE or FWRITE 
request; it delays write completion until a succeeding 
unsolicited input is received. No read completion is 
scheduled. WRITE-READ is rejected if the port is not 
connected. 
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ER DESCRIPTIONS 

FOR MASS MEMORY DRIVERS 
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1866-14 CARTRIDGE 
DISK DRIVER (CDD) 

Data is transferred to and from disk mass-storage devices. 
The device driver performs formatted FREAD/FWRITE 
(sector addressing) and unformatted READ/WRITE (v^ord 
address simulation) requests and processes motion requests 
that result in no operation. The mass-memory driver also 
detects an overlay of the requestor's parameter list by a 
READ operation. In that event, sufficient information is 
moved from the user's parameter list to the physical device 
table to allow the completion routine to be executed. 

The hardware compare feature is optional for the CDD disk 
driver. It is enabled by resetting bit 15 of the unit select 
code in the unit's physical device table to a zero; it is 
disabled in the standard delivered system. 

For systems having more than one drive, overlapping seek 
operations are utilized for maximum data transfer 
efficiency. The software driver for the CDD initiates all 
required seek operations before starting a data transfer for 
a device that is on cylinder, thus overlapping the seek on 
several devices with data transfer on another device. 

Cartridge disks utilize a single fixed disk and a single 
removable disk in a cartridge case. The disks are referred 
to as disk and disk 1; each has two recording surfaces. 
They are individually addressed by the hardware controller 
and differentiated by a single bit designator within the file 
address word. 

Software users reference the entire cartridge disk drive as 
a single logical unit with disk containing the lowest 
sector address and disk 1 containing the highest. The 
position of the toggle switch determines which disk is to be 
addressed. 



NOTE 

Cartridge disk drives have one or two 
switches (depending on model) labeled 
WRITE PROTECT. When a switch is set, 
no data can be written on the selected 
(fixed or removable) disk platter. It is 
the operator's responsibility to place the 
switches in the desired position. 



The first request format is consistent with normal requests 
(the X parameter is not set) by providing a seven-word 
format. 

If the X parameter is set, it indicates an indirect reference 
to the first word address increment contained in the s 
parameter. This positive increment is added to the address 
of the parameter list to form the address of a location 
containing another positive increment. The second 
increment is added to the address of the parameter list to 
obtain the starting address. This second increment is 
immediately followed by two words which contain the mass 
storage address (MSA) and which must comply with the 
first request format. 



If parameter x is zero, both s and s" are absolute addresses; 
otherwise, they are 15-bit positive increments that are 
added to the address of the first request parameter (word 
zero) to form absolute addresses. Control is returned to 
the location following word five after the request is made. 



If P (bit 15 of the MSB word) is =1, current control point is 
part of the request; otherwise it is ignored. 

The first request format is as follows. 



DATA TRANSFER REQUEST FORMATS 





15 


14 


13 12 


11 10 9 


8 


7 4 


3 







RTJ-($F4) 








d 


re 


X 


rp 


cp 


1 


c 


2 


THREAD 


3 


w 





a 


lu 


4 


n 


5 


1 


s" 


« 


!• 


EXECUTABLE CODE 




1 











s 




p 


MSA MSB 30 -15 







MSA LSB 14-0 




CONTROL POINT- (IF P = 1) 



Execution of the data transfer request transfers n words 
from mass storage (READ/FREAD) or to mass storage 
(WRITE/FWRITE), starting at any memory first word 
address indicated by s and the mass storage address 
indicated by MSA. If n is zero, one word is transferred. 
No data formatting is involved since corresponding memory 
and mass storage locations contain identical 16-bit images. 



The second request format adds two words that contain 
mass storage address in line with the conventional data 
transfer format and that are identified by a direct 
reference to s (bit 15 equals 0). 
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The conventions defined previously for s in relation to x 
and d also apply here. Control is returned to the location 
following word eight after the request is made. The second 
request format is as follows. 





15 


14 


13 


12 


11 10 


9 


8 


7 4 


3 







RTJ-($F4) 1 








d 


re 


X 


rp 


CP 1 


1 


c 


2 


THREAD 


3 


V 





a 




1 


4 


n 


5 





s 


6 


P 


MSA MSB 30-15 


7 





MSA LSB 14-0 




CURRENT CONTROL POINT- (IF P = 1) | 



FREAD/FWRITE 

FREAD and FWRITE requests utilize the sector orientation 
of the disk. The formats of FREAD and FWRITE are the 
same as READ and WRITE. The mass storage address 
represents a sector number; n represents the number of 
words to be transferred. If n is not a multiple of 96 for an 
FWRITE request, the unused words of the last sector are 
set to zero. 

FREAD - FREAD fills memory, starting at a requested 
address, with the specified number of words. If zero words 
are requested, one word is transferred. 

FWRITE - This request transfers the specified number of 
words from memory to disl<. The starting disk address is 
interpreted by the driver as a sector address; the most 
significant bits must be zero. If a zero number of words is 
requested, one word is transferred. The remainder of a 
partially updated sector is not preserved. 



MOTION 

MOTION requests to the disk result in no action, and return 
from the disk is through a normal completion procedure. 



DISK DRIVER REQUESTS 

READ/WRITE 

READ and W^ITE requests provide the ability to simulate 
the word address by allowing the mass storage address to 
be any word address within the size range of the disk. The 
driver converts the word address to sector and word in the 
sector by dividing by 96. 

READ - The READ request fills memory with the specified 
number of words starting at a specified address. If zero 
words are requested, one word is transferred. Transfer is 
initiated from the disk word address specified by the most 
significant bits (MSB) and least significant bits (LSB) of the 
request (least significant bit is a 15-bit value). A carry 
into bit 15 of the least significant bits should be treated as 
an overflow condition and the most significant bits should 
be incremented by one. 

WRITE - The WRITE request transfers the requested 
number of words from memory to disk. The disk starting 
address (most significant bits, least significant bits) is 
interpreted by the driver as a word address. When v/riting 
on the disk in this mode, the remainder of partially updated 
sectors is preserved. 

A partial sector WRITE request caises: 

• The entire sector to be read into a buffer in the driver 

p The user's data to be moved into the appropriate 
portion of that buffer 

• The entire buffer to be written onto the disk 



STATUS AND ERROR HANDLING 

Status bit definition for the cartridge disk drive controller 
is as follows: 



15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 



BUS BUSY 1 

CONTROLLER 
PROTECTED • 

DEVICE SEEK 

ERROR 

ON BUS 



END OF OPERATION 



L 



READY 
BUSY 

INTERRUPT 

ALARM 

ON-CYLINDER 

DISK WRITE PROTECTED 

NOT USED 

SINGLE DENSITY 



The following errors are detected by the driver: 

00 Timeout 

01 Lost data 

02 Incorrect device transfer or sector format - alarm 

03 DMA device parity error 

05 Internal reject 

06 External reject 
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07 


Compare 




13 


Write protected 




14 


Not ready 




16 


Controller seek error 




17 


Seek error 




18 


End of medium 




19 


DMA protect fault 




20 


Checkword error 


^^■' '■ 


49 


Address error 


i; 


50 


Missing index sector pulse 


84 


Bus reUnquished 





\ ■ i 



85 Errors in current word address, bank status, true 
cylinder, and true sector 

88 Data address error 



1867-10/20/40 AND 1868-1 
STORAGE MODULE 
DRIVE (SMD) DRIVER 

This driver handles CYBER 18 data transfers to and from 
any mix of 25, 80, and 300 megabyte SMD and MMD 
hardware (up to 8 drives). 



Current control point (CCP) indicates the segment of 
memory from which the request originated. The data 
transfer must remain within this segment. MSOS Versions 
has a mass memory manager, hence word 8 (CCP) is not 
required. 

P =1 indicates that current control point is part of 
the calling sequence. 

P =0 Word 8 is omitted from calling sequence. 

The maximum buffer size for input and output disk 
transfers is 65K. If a write transfer extends across a 
cylinder boundary, the disk handler divides the request into 
two sections, but this operation is transparent to the using 
program. 



DRIVER DESCRIPTION 

The driver controls the module .drive adapter and 
controller. That unit in turn controls up to eight modular 
drives. The driver may be installed in a single- or 
dual-CPU configuration. Each CPU that accesses the disk 
must contain disk adapter hardware, which is used primarly 
to check track and sector address. If the requested address 
differs from the address read, the data transfer is 
inhibited. The maximum hardware configuration for this 
driver is shown in figure 4-1. 

The use of the single controller by the two CPUs is serial, 
not parallel. Disk control is regulated by the drive status 
usage table. At autoload time, the SPACE program of the 
driver in one CPU takes control of the table, clears it, and 
autoloads. The other CPU must not attempt to access disk 
during this period. Thereafter, the drivers of both CPUs 
use the table to gain and release control of the control unit. 



•REQUEST FORMAT 

The standard request formats for the read and write 
requests (formatted or unformatted) are used and are 
described in section 1 with the following changes (direct 
format shown). 



A safeguard is provided to prevent one CPU from locking 
out the other CPU. When one CPU has terminated its use 
of the controller, an alternate disk adapter interrupt is 
generated for the second CPU. The second CPU may then 
process its drive requests. 





15 


14 












1 




2 




3 




4 




5 




6 


P 


MOST SIGNIFICANT BITS 


7 





LEAST SIGNIFICANT BITS 


8 


CURRENT CONTROL POINT 



STANDARD 

6-WORD 

REQUEST 



MASS 

STORAGE 

ADDRESS 



The first added words (words 6 and 7) are necessary to 
specify the disk address. 



When a CPU controls the disk, all seek operations must be 
handled first. The control unit allows overlapping seek 
operations on each disk drive except the one on which a 
read/write operation is currently taking place. The seek 
operations cannot be commanded by the user, that is, a 
MOTION command results in a no-operation. The driver 
itself develops a seek command as the first step of a 
READ, WRITE, FREAD, or FWRITE operation. Further, the 
seek complete interrupt is transparent to the user, since 
this is handled entirely within the driver. If the seek 
command positioned the driver heads properly, the 
read/write transfer is initiated when it is the first such 
transfer in queue. 



In addition to the five-second diagnostic timeout, three 
other timeout periods are provided by the driver: one 
second to complete a seek operation, one second to 
complete a read/write operation, and three seconds to 
complete the alternate disk adapter interrupt. The latter, 
therefore, requires the requesting CPU to take control of 
the control unit within three seconds of the time when the 
using CPU has indicated it is ready to release the disk. 
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CYBER 18-xx' 



DRIVER I 



MODULE DRIVE 
ADAPTER GB138-A 
OR GB145-A 



CPU 



MODULE DRIVE 

CONTROLLER 

FA727-A/D 



DRIVE 



MODULE 
DRIVE 



MODULE 
DRIVE 



MODULE 
DRIVE 



CYBER 18-xx' 



DRIVER I 



MODULE DRIVE 
ADAPTER GB138-A 
OR GB145-B 



CPU 



MODULE 
DRIVE 



MODULE 
DRIVE 



MODULE 
DRIVE 



MODULE 
DRIVE 



MODULE 
DRIVE 



"^UP TO 2S6K WORDS OF MAIN MEMORY 



2467 



BJ701^/K 
BJ701-A/B 
BI402-A/B 
BZ403-A/B 



MODULE DRIVE TYPES 

WO. HEADS NO. CYLINDERS 

40MBSMD 5 411 

80MBSMD 5 823 

300 MB MAXI 19 823 

24 MB MINI 4 320 



Figure 4-1. Module Drive Driver Maximum Hardware Configuration 



ERROR RECOVERY 

The driver provides automatic recovery for four of the five 
types of errors that can be encountered on mass storage 
requests. In the irrecoverable cases, an error code is 
logged in the engineering file if the operation failed after 
the maximum number of error recovery attempts. The 
error code is also saved in the status word for return to the 
user program (status values are described below). The 
maximum number of error recovery attempts for each type 
of failure is a prestored parameter in the physical device 
table (PHYSTB). Except for the error correction code 
(ECC) generated by write errors (described below), no 
indication of corrected errors is saved. No error will be 
logged if the unit is inactive or if it is the diagnostic 
logical unit. 



Control Unit Connection Error 

The connection is attempted five times. If the control unit 
is currently being used by the second computer, the 
diagnostic clock (5 seconds delay) is started and no error is 
logged. If the control unit should be available but cannot 
be connected after five retries, thetransfer is aborted and 
an error code of 70 is returned to the user. 



Drive Connection/Seek Error 

Five retries are allowed to connect the disk drive. The 
error code is 70 if the connection fails. After the drive is 
connected, the driver checks ready status. If the unit 
cannot be made ready, the error code is 14. Then seek 
status is checked when the seek interrupt is received. 
After the maximum number of retries (a physical device 
table parameter) has failed, the error code is 17. 
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Error Correction Code Error 



On all write operations a special code is generated in line 
with the data within the sector. The code can detect a 
head error up to 22 bits in length per sector and can 
automatically correct an error up to 11 bits in length. The 
error correction code recovery attempt is selected by a 
flag set in the physical device table. If the error exceeds 
11 bits in length and is therefore uncorrectable, the error 
code is 71. 



The pack formatter (SMD2F) contained in ODS level II, 
which is used to format packs for ITOS only, maps out bad 
spots on the media if they exist. By definition a bad spot is 
an area within a sector that exhibits a data error greater 
than 11 bits in length. The encounter of a bad spot during 
a READ/WRITE request will be transparent to the user. 
SMD2F will have set the bad sector bit in the address tag 
of the sector containing the bad spot. In addition to the 
setting of the bad sector bit, the address of a replacement 
sector is placed in the flag bytes of the address tag. 
Replacement sectors are made available on the last 
available cylinder of the media. For each bad sector two 
replacement sectors are used. The first replacement 
sector is used to retain the data that would normally reside 
at the bad sector. The second replacement sector is used 
to vector back to the bad sector +1 in the same manner as 
the bad sector vectored to the replacement sector. At 
each encounter of a sector that is marked with the bad 



sector bit, an alarm error interrupt will inform the driver 
that this sector is to be replaced. 



CAUTION 

The last two tracks of the disk pack are 
used for bad sector replacement and 
must not be used if bad sector 
replacement occurred during pack 
formatting. 



Data Transfer Error (Read) 

Because of the high density of data packing, positioning of 
the head over the track is critical, both in line with the 
data in the track (strobing variations) and perpendicular to 
the track (head offset variations). This type of positioning 
error is most frequently caused by recording data on one 
disk drive and reading it back from another. See figure 4-2. 

To counter this type of error, the driver automatically 
retries reading the data using numerous combinations of 
offset positions and strobing variations, the total number 
being controlled by parameters in the physical device table. 

If no offset/strobing combination succeeds in reading the 
data, the error code is set to 41. 



1 POSITION / 
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Figure 4-2. Head Positioning 
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Error Codes 

The error codes for all errors are; 

Code Definition 

I/O hang up (one-second data transfer 

timeout) 

2 Alarm error (hardware) 

5 Internal reject 

6 External reject 
10 Mis-seek 

14 Unit not ready (disl< drive) 

17 Seek error 

41 Unsuccessful request (data transfer error) 

70 Connect error (control unit or disk drive) 

71 Uncorrectable by error correction code (read 
or write) 

82 Control unit error (includes write protect 
errors due to write protect switch on) 

83 Mass storage address error (disk adapter 
addresses nonexistent main memory) 

An error message of the following form is displayed when 
mass memory errors prevent further processing. 

MM ERR ee LU=lu T=hhmm:ss S=ssss 

Where: 

ee is error code 

lu is logical unit 

hhmm is hour and minute 

ss is second 

ssss is DA status of drive. (This status does not 
always reflect the status that caused the 
failure.) 

DA status is shown below: 



The following hardware statuses can be found in the 
physical device table assigned to a failed device. Note 
that the values in the table do not always reflect current 
status. 

CU status is shown below: 



18 14 13 12 n 10 9 8 7 6 S 4 3 2 1 



L, 



CU REQUEST 
LOST DATA/PARITY ERROR 

ECC ERROR 

CU INST. EXEC. INCOMPLETE 

CMO SEQ/OVERRUN ERROR 

POWER FAILURE 

DRIVE STATUS ERROR 

INTERFACE PARITY ERROR 



Drive status 1 is shown below: 



15 14 13 12 11 10 9 a 7 6 5 4 3 2 10 



L. 



W. OFFSET ACTIVE 
NO SERVO CLOCK 

(R+W) • ATTENTION 

ADDRESS MARK NOT FOUND 

SYNC BYTE NOT FOUND 

CHECK FAULT STATUS 

SECTOR OR INDEX NOT FOUND 

MULTIPLE OR NO UNIT SELECTED 



Drive status 2 is shown below: 



15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 



ADDRESS I 
FIELD ' 

CU ERROR - 



PROTECT FAULT—* 

STORAGE 

PARITY ERROR 
MEMORY ADDRESS ERROR 



FORCED RELEASE 

LOST DATA 

PROTECTED 



IL. 



BUSY 

INTERRUPT 

CU SELECTED 

TRANSFER COMPLETE 

ALARM 

SEEK END 

END OF CYUNDER 
ALT. DA INTERRUPT 



15 


14 


13 


12 


11 


10 


9 


8 


7 


6 


5 


4 


3 


2 




1 
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Drive fault status is shown below: 



MSB LSB 

15 U 13 12 11 10 9 8 7 6 5 4 3 2 1 



L. 



WRITE PROTECT 
SEEK ERROR 

HEAD SELECT FAULT 

VOLTAGE FAULT 

WMl FAULT 

W+R OFF CYLINDER 

WRITE FAULT 

NO HEAD SELECT 



DISK PACK INITIALIZATION FORMAT 

The disk packs for the disk driver consists of several 
platters: an inner and outer protective platter, and inner 
platters for magnetic information. One full surface is 
Preformatted for head positioning (die bits). This feature 
allows the head to be offset perpendicular to the track. As 
a result, slight misalignments from pack to pack and drive 
to drive may be automatically compensated by the driver 
to preserve the stored information. This was discussed in 
the error recovery section. 

The media residing on any module drive is partitioned into 
cylinders, tracks and sectors. A cylinder is defined as the 
set of tracks that can be accessed on a single disk pack 
without head movement. A track is defined as the set of 
sectors that can be accessed by a single read/write head 
without head movement. For example, the 80 megabyte, 
BJ701-AB storage module drive has five tracks per 
cylinder, and up to 64 sectors per track. If 64 sectors exist 
per track, each sector contains 96 words. 

Sector identification is determined at system 
ordering/configuration time. The sequence of sector 
identifications is held in a sector addressing table (part of 
the address tag routine). 

Disk media must be formatted prior to being used. A 
formatting module is provided as a part of the systems 
materials. The user is referred to the appropriate system 
installation handbook for details. 



DIAGNOSTIC FEATURES (OPTIONAL) 

Some diagnostic features included in the driver are 
optional. These diagnostic features must be defined during 
the system ordering/configuration phase. The diagnostic 
buffer in which the parameters are defined is provided 
within the user's request area. The physical device table 
for the disk is included in appendix C. 

The additional requirements specified in the physical 
device table of the test unit during initialization are: 

• The diagnostic unit (word 17, DIAGLU) must be 
designated as the read/write request logical unit 
number. 



The diagnostic request type code (6, 9, and 10 for 
format write pack initialize, read address tags, and 
write address tags, respectively) must be inserted into 
bits 3 through of word 52 (DIAGSP) of the physical 
device table of the requested unit. 

The standard driver specifies that one retry should be 
made for each combination of strobe/offset. 
However, there is the option of selecting combinations 
for diagnostic operation and retrying selected 
combinations more than once. The allowed data 
transfer error retrial value must be set to zero, the 
strobe and offset value (labeled STROBE, word 64 in 
the physical device table of the unit) is set to a 
desired value (upper eight bits) before calling the 
driver. 



The value(s) changed by the diagnostic unit must be 
restored when the diagnostic function is completed. When 
the caller regains control, the last status of the disk 
adapter, control unit, and so forth, is stored in the 40-word 
diagnostic status buffer (see the DILUSS module of the 
module driver DSMD). 

For read/write address tags operation, it is advisable to set 
up the MSOS read/ write request as formatted. This 
eliminates the odd word format (five words per address tag 
data), which can create errors if the unformatted MSOS 
type read/write request is used. Furthermore, the address 
tag operation is a track type function, so it is advisable to 
force any starting mass memory address to be the 
beginning address of a track. 

Following a diagnostic operation, the caller regains control 
regardless of the error detected during the I/O operation. 
The error encountered is not logged in the engineering file; 
instead, the caller regains control as if a successful 
operation occurred. However, the error code is stored in 
word 16, labeled FLTCOD, in the unit's physical device 
table. The proper error retrial count, if applied, is stored 
in its type counter (such as word 40 for seek error count). 
It is the responsibility of the caller to examine these 
counters in conjunction with the status words to determine 
the proper result. 



ITOS 2 FLEXBBLE DISK DRIVER 

This driver handles data transfers to and from the flexible 
disk. 

The driver performs four major functions: 

• Disk transfers 

• Error recovery and logging 

O Diagnostic logical unit support 

• Verify write operation 



The flexible disk unit (diskette) consists of a single surface 
with 77 tracks. To perform a data transfer, the head is 
positioned over the appropriate track and a loading device 
presses the disk against the head so the transfer can take 
place. 
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Three control pushbuttons on the console alter flexible disk 
operations: 

INIT ENABLE Not functional on standard systems. 

WRITE ENABLE When lit, WRITE ENABLE allows 
writing to the flexible disk unit. 



UNIT REVERSE 



When illuminated, the UNIT 
REVERSE causes the controller to 
reverse the diskette identity from 
that set in the controller (that is, 
unit expects to be addressed as 
unit 1). 



DATA FORMATS 



The ITOS driver and standard hardware configuration do 
not support the DMA transfers required to format 
(initialize) flexible diskettes. Two separate data formats 
(as shown in table 4-1) can be used and are determined at 
tlie time the diskette is formatted. 



generated for both sector addresses and for data. If an 
unrecoverable error is encountered, a composite of the 
errors is generated as a transfer status, and this 
information is returned to the calling program. 



READ/WRITE 

Unformatted I/O requests are treated as word-addressed 
requests. The user need not supply any special bank 
addressing information in the request. 

Word-addressable transfers start at the next word on disk 
and continue uninterrupted across sector and track 
boundaries. 



FREAD/FWRITE 

These read and write commands are oriented to the 
sector/track formatting scheme and are as described below: 



TABLE 4-1. DATA FORMATS 



Format 


Word/ 
Sector 


Sectors/ 
Track 


Tracks/ 
Drive 


Number of 

Drives 

(Maximum) 


Total 
Words 


CDC 
IBM 


96 
64 


19 
26 


77t 
77t 


2 
2 


281K 
256K 


^74 only are available to user programs 



WORDS/SECTOR 



SECTORS/TRACK 



SECTOR FOR TRANSFER 



, STANDARD 
> REQUEST 



Formatted diskettes for either format may be purchased 
from CDC. 

Sector numbering for word addressing purposes begins at 
logical sector 0, which is normally physical sector 1 on 
physical track 1 (physical sector numbering begins at 1, not 
0). This is also transparent to the user program, except 
that the program must not attempt to do a format write 
operation (sector addressed transfer) to the autoload 
sectors. 

When a diskette containing data is loaded into the system, 
the data format is obtained from the newly loaded diskette. 

The transfer of data is made using A/Q data transfers. 
Auto data- transfer is not available. The diskette may be 
used as a word -addressable device (READ or WRITE 
requests) or as a sector-addressable device (FREAD or 
FWRITE requests). 

Preset error recovery processes are available for data 
transfers and preliminary seek operations. Error 
procedures are usually triggered by a cyclic redundancy 
check (CRC) comparison error. The CRC code is 



The n parameter determines the number of words to 
transfer. If n is not a divisor of a sector on an F"WRITE 
request, the data is transferred to the following sector and 
the balance of that sector is zero filled. On a FREAD 
request, only the specified number of words is transferred; 
this in effect masks out the remainder of the last sector. 



MOTION 

All MOTION requests are ignored. 



ERROR RECOVERY 

The user has no control over the error recovery sequence. 
On I/O requests the driver attempts to complete the 
request up to ten times. If unsuccessful, the driver 
develops the error status word and places it in the physical 
device table. 

The failure, but not the failure type, is reported to the 
normal user. If the diskette is being used as diagnostic 
unit, the nature of the error is saved in the diagnostic 
expansion of the physical device table. The error codes 
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appear as a bit assignment. The last equipment status 
appears in ESTAT2 (word 12) of the physical device table 
and has the following meaning: 



Bit 


Definition 





Unit ready 


1 


Unit busy 


2 


IHead loaded 


3 


Seeking 


4 


Reading/writing 


5 


Interrupt 


6 


Interrupt selected 


7 


Not used 


8 


Not used 


9 


Not used 


10 


Lost data 


11 


Seek error 


12 


Data cyclic redundancy check error 


13 


Deleted record 


14 


Protect switch on 


15 


Controller busy 



This is not actual hardware status but a composite status 
formed by a driver module based on the information 
supplied by the hardware status. 

The hardware status consists of the controller and unit 
status. 

The error messages (numbers appearing on the comment 
device) are listed below: 



Code 



Definition 






Timeout fault 


1 


Initiator group status error 


2 


Continuator group status error 


3 


Time out group status error 


4 


Speed deviation error 


5 


Internal reject 


6 


External reject 


7 


Short/long transfer error 


8 


Track/sector fault 


9 


Status fault(s) after bad track read 


10 


Status fault after I/O transfer 


11 


Excessive error recoveries for media 



ACCESSING FLEXIBLE DISK 

The flexible disk is supported as a magnetic tape 
compatible device via the magnetic tape simulator and is 
accessed by the device name FLEXTAPE. If the diskette is 
to be written to in this mode, the control panel WRITE 
ENABLE switch must be on. In addition, the write ring for 
the magnetic tape simulator must be enabled by manually 
interrupting and typing: W^ON,lu (where lu is the logical 
unit of the flexible disk magnetic tape simulator unit). 



MSOS 5 FLEXIBLE DISK DRIVER 



This driver handles data transfers to and from the flexible 
disk. Two flexible disk units (diskettes) may be controlled 
from the same flexible disk control unit. Each diskette is 
identified as a separate logical unit. The identity of a 
diskette (0 or l) is determined by a switch in the 
controller. Since each diskette has its own physical device 
table that contains parameters determining the addressing 
structure of the diskette as well as current and recent data 
transfers, the switch position cannot be changed without 
interchanging the diskettes. 

Three control pushbuttons on the console alter flexible disk 
operations: 

INIT ENABLE Not functional on standard systems. 

WRITE ENABLE When lit, WRITE ENABLE allows 
writing to the flexible disk unit. A 
diskette may be individually write 
protected, in which case writing 
cannot occur on that diskette, even 
if the switch is lit. (See motion 
requests for write enable.) 

UNIT REVERSE When illuminated, the UNIT 
REVERSE causes the controller to 
reverse the diskette identity from 
that set in the controller (that is, 
unit expects to be addressed as 
unit 1). 

In a dual-diskette system, one diskette can be transferring 
data while the other unit is performing a seek operation. 

The driver is written in kernel fashion. The entire driver 
may be mass-storage resident as described in section 2. 

The driver performs six major functions: 

• Data transfers 

• Error recovery and logging 

• Diagnostic logical unit support 

• CPU main memory bank addressing 

• Overlay processing 

O Verify write operation 



The flexible disk unit (diskette) consists of a single surface 
with 77 tracks. To perform a data transfer, the head is 
positioned over the appropriate track and a loading device 
presses the disk against the head so the transfer can take 
place. 
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DATA FORMATS 

The standard hardware configuration does not support the 
DMA transfers required to format (initialize) flexible 
disl<ettes. Two separate data formats (as shown in 
table 4-1) can be used and are determined at the time the 
diskette is formatted. 

Formatted diskettes for either format may be purchased 
from CDC. 

Sector numbering for word addressing purposes begins at 
logical sector 0, which is normally physical sector 1 on 
physical track 1 (physical sector numbering begins at 1, not 
0). This is also transparent to the user program, except 
that the program must not attempt to do a format write 
operation (sector addressed transfer) to the autoload 
sectors. 

When a diskette containing data is loaded into the system, 
the diskette format, bad track sectors, read/write, and 
write compare options are obtained from the newly loaded 
diskette. Because the two devices are totally separate 
logical units, it is possible to have one diskette formatted 
for IBM compatibility and one formatted to CDC 
standards. Likewise, a CDC-formatted diskette could be 
followed by an IBM-formatted diskette in the same physical 
slot. 

The transfer of data is made using A/Q data transfers. 
Auto data transfer is not available. The diskette may be 
used as a word- addressable device (READ or WRITE 
requests) or as a sector-addressable device (FREAD or 
FWRITE requests). Locating a word or sector physical (for 
diagnostic purposes) is described below. 

To increase the speed of A/Q read operations, for more 
than one continuous sector transfer, diskettes may be 
interlaced at the time they are initialized. This procedure 
noticeably speeds up A/Q reading of binary data (about 500 
percent) but slows down reading of deadstart data. 
Interlacing is done only at the time a diskette is 
initialized. It is transparent for all functions. (For 
example, an interlaced diskette can be copied to a 
non-interlaced diskette with no change of data.) 

Sectors are interlaced as follows: 

Sequential IBM CDC 

Address Interlaced Interlaced 



1 

14 
2 
15 



1 

11 
2 
12 



Preset error recovery processes are available for data 
transfers and preliminary seek operations. Error 
procedures are usually triggered by a cyclic redundancy 
check (CRC) comparison error. The CRC code is 
generated for both sector addresses and for data. If an 
unrecoverable error is encountered, a composite of the 
errors is generated as a transfer status, and this 
information Is returned to the using program. 



READ/WRITE 

Unformatted I/O requests are treated as word addressed 
requests. The request format is substantially the same as 
described for storage module drive requests. However, the 
control point logic used for addressing CPU main memory 
is not available. Instead (and only if the bank addressing 
option is present), the driver uses the 18-bit address of the 
buffer area to interface with the MSOS that controls the 
CPU. The user need not supply any special bank addressing 
information in the request. 

Word-addressable transfers start at the next word on disk 
and continue uninterrupted across sector and track 
boundaries. 



CAUTION 

WRITE, with the ASCII bit set writes a 
deleted record. A deleted record may be 
read or written; such a record appears 
the same as a normal record except that 
bit 13 of the v field in word 3 equals 1. 



To calculate a disk sector/track physical address from a 
31-bit disk word address, divide the word number by 96 
(CDC) or 64 (IBM). Next divide the resultant sector 
number (discarding the word remainder) by 19 (CDC) or 26 
(IBM) to obtain the offset track identification (discarding 
the sector remainder). Any bad track in this track address 
must be compensated for. Bad tracks are designated in 
word 27 of the physical device table (appendix C). Add the 
calculated track address x (x = 1 plus the number of bad 
tracks below this track) where 1 < x < 3. Using this track 
address, the driver commands a seek operation. When the 
seek has been completed, the driver handles the 
seek-complete interrupt. All of this is transparent to the 
user so long as no seek error occurs. If an unrecoverable 
seek error occurs, the user program is notified of an error, 
but not of the type of error. (However, if the diskette is a 
diagnostic logical unit, the type of error is specified to the 
user.) 



18 
19 



25 
26 



22 
10 



13 
26 



19 
10 



FREAD/FWRITE 

These read and write commands are oriented to the 
sector/track formatting scheme and are as described for 
storage module cklve requests except for the control point 
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word. The least significant bit of the mass storage address 
indicates that the address is to be interpreted as a logical 
sector address (not a track/sector address). The n 
parameter determines the number of words to transfer. If 
n is not a divisor of a sector (96 for CDC or 64 for IBM), 
the remainder of the sector is transferred anyway on an 
RA/RITE request. However, the remainder of the sector is 
filled with zeros. On a FREAD request, only the specified 
number of words is transferred; this in effect masks out 
the remainder of the last sector. 



CAUTION 

An FWRITE with the ASCII bit set results 
in the flexible disk driver writing address 
tags (diskette initialization) to a specific 
track, the least significant bit of the 
mass storage address contains the logical 
sector address that references the first 
sector of a track. The most significant 
bit contains the number of sectors/track 
in bits through 7 and the words/sector 
bits 8 through 15. The I/O request must 
be preceded immediately by a MOTION 
request (with a code of 1). The MOTION 
request permits the initialization to 
occur. If the I/O request is not preceded 
by the MOTION request, a deleted 
record is written. 

Notice that other user's I/O request 
cannot be issued to the same logical unit 
while a program is using the privileged 
MOTION request to change the state of 
the I/O request. 



MOTION 

If the diagnostic logical unit option is included, the driver 
recognizes the MOTION request discussed in section 1. 

However, the fourth hexadecimal bit always equals 0. The 
three motion codes (pi, p2, and p3) are processed in that 
order. Values for the p codes are as follows: 



Code Definition 

Terminate request 

1 Not used 

2 Request no data compare during write 

3 Request data compare during write 

4 Change diskette mode to READ/WRITE 

5 Change diskette mode to read only (option) 

6 Not used 

7 Not used 

The I/O options are summarized in table 4-2. 



ERROR RECOVERY 

The user has no control over the error recovery sequence. 
For read errors the error recovery sequence is as follows: 

1. The driver tries to read at the given address 10 times. 

2. The driver seeks a track two tracks away, then reseeks 
the specified track and attempts to write. This is 
done five times. 

3. The driver seeks logical sector 0, then reseeks the 
specified track and attempts to write. This is done 
five times. 

4. The driver develops the error status word and places it 
in the physical device table. (See appendix C.) 

For write errors the error recovery sequence is as follows: 

1. The driver tries to write to the specified address two 
times. 

2. The driver seeks logical sector 0, then reseeks 
specified track and attempts to write. This is done 
twice. 

3. The driver develops the error status word and places it 
in the physical device table. 

The failure, but not the failure type, is reported to the 
normal user. If the diskette is being used as diagnostic 
unit, the nature of the error is saved in the diagnostic 
expansion of the physical device table. The error codes 
appear as a bit assignment. The last equipment status 
appears in ESTAT2 (word 12) of the physical device table 
and has the following meaning: 

Bit Definition 

Unit ready 

1 Unit busy 

2 Head loaded 

3 Seeking 

4 Reading/writing 

5 Interrupt 

6 Interrupt selected 

7 Direct memory access parity error 

8 Direct memory access protect fault 

9 Direct memory access memory address fault 

10 Lost data 

11 Seek error 

12 Data cyclic redundancy check error 

13 Deleted record 

14 Protect switch on 

15 Controller busy 
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TABLE 4-2. FLEXIBLE DISK COMMANDS 



Definition 


I/Ol 


Format2 


Mode3 


Count4 


Prints 


Logical Unit6 


READ 




















READ 














X7 


X 


FREAD 





1 














FREAD TRACK 1 





1 








X 


X 


FREAD TRACK 





1 








1 


1 


WRITE 



















WRITE 
















X 


DEL. REC. WRITE 




X 


1 


X 





X 


FWRITE 




1 














FWRITE TRACK l8 




1 











X 


FWRITE TRACK 08 




1 








1 


1 


DEL. REC. FWRITE9 




X 


1 


X 





X 


INITIALIZATION 




1 


1 





1 


X 


SEEK ONLY 





X 


X 





1 


1 


STATUS ONLYlO 





X 


X 








1 


NOTES: 








1. I/O: 


) = Read operation 
1 = Write operation 






2. Format: 


) = Unformatted sector read/write 

1 = Formatted word addressable read/write 






3. Mode: 


D = Binary 
1 = ASCII 






4. Count: 


I/O word count 






5. Prime: 


) = Not proceeded with a motion code of 1 
1 = Proceeded with a motion code of 1 






6. Logical unit: 


) = Not a diagnostic logical unit 
I = Diagnostic logical unit 






7. X: 


Not applicable 






8. Track 1: 
Track 0: 


-ogical sector addressing starts with track 1 
Logical sector addressing starts with track 






9. DEL REC: 


Deleted record 






10. Status 


Located in physical device table after request 
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This is not actual hardware status but a composite status 
formed by a driver module based on the information 
supplied by the iiardware status. 

The hardware status consists of the controller and unit 
status. 

Not all errors are reported in the engineering log for this 
logical unit. The physical device table contains a threshold 
value for error retries. When the number of recovery 
attempts of a given type reaches that value, the error 
count is cleared and an entry is made in the engineering log. 

The error messages (numbers appearing on the comment 
device) are listed below: 

Code Definition 

Time out 

1 Lost data 

1 Bad initiator pseudo status 

2 Bad continuator pseudo status 

3 Bad timeout pseudo status 

3 Parity error 

4 Status f ault(s) after I/O 

5 Internal reject fault code 

6 External reject fault code 

13 Read only diskette 

14 Unit not ready 

16 Track/sector fault 

18 Invalid sector address 

19 Protect error 

20 Data compare error 

48 Controller address error 

61 No interrupt 

65 No interrupt selected 



Code 



Definition 



66 


Memory address error 


68 


Unexpected interrupt 


69 


Initialization not enabled 


76 


Fault indicator for logging recovered errors 


77 


Expected reject did not occur 


78 


Short/long transfer error 


79 


Unit busy 


80 


Unit seeking 


81 


Unit doing I/O 



SPECIAL FEATURES 

Overlay requests cause the driver to check the location of 
the requester's parameter list (for example, READ 
request). If it is overwritten by the projected overlay, 
sufficient information is saved from the request in the 
physical device table to allow the request to be completed. 



NOTE 

Not enough information is saved to 
repeat the request using the alternate 
device handler. 



Unprotected requests are saved at the beginning of scratch 
mass memory in logical sector 1. 

The optional compare data logic compares data just 
written to tlie diskette with the data in the user's write 
buffer. The user must supply his own buffer for this 
function. 



FLEXIBLE DISK UTILITY 

The flexible disk utility program described in appendix F is 
included in the program library for all MSOS systems 
containing flexible disk drives. 
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FOR LINE PRINTER AND CARD READER DRIVERS 



ms^m 
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Tmsm 



LINE PRINTER DRIVERS 



WRITE/FWRITE 

WRITE and FWRITE requests are honored by the line printer 
drivers. Binary/ASCII mode has no significance and is 
ignored. 

The drivers print tp to 136 characters per line. The 
requestor out{3ut buffer may be any length, provided that 
each print line contains an embedded control character. If 
more than 136 characters are supplied for one line, the 
additional characters are ignored. 

These drivers can use either FORTRAN or non-FORTRAN 
mode. The physical device table of the printer contains 
the logical unit number of the FORTRAN line printer. If 
the logical unit number specified in the request is the 
same, the FORTRAN mode of operation is used. All other 
logical unit numbers are handled in the non-FORTRAN 
mode. 

The FORTRAN FWRITE mode interprets tiie first character 
of the record as carriage control information. The 
follov*/ing are carriage control characters. 



CHARACTER EDITING 



Character 


Action Before Printing 


Q 


Space two lines 


1 


Page eject 


+ 


No space 


all others 


Space one line 



The non-FORTRAN FWRITE mode upspaces one line before 
printing, and the first character of the record is printed. 

In both the FORTRAN and non-FORTRAN modes, the 
unformatted WRITE does not cause a preceding upspace and 
the first character is printed. It prints the buffer only 
when a control character that causes a print or paper 
motion is encountered. 



MOTION 

MOTION request codes 2 and 4 are honored by the drivers. 
All other MOTION • requests cause a normal request 
completion with no action. 



Code 
2 
4 



Definition 
Page eject 
Reset line count 



All characters are edited as follows before they are sent to 
the print buffer: 



Character 
20l6- 5Fi6 

60l6- 7Ei6 

0316- EOT 
04i6- EOT 
09i6- HTAB 
OAjg- Line feed 
0Bi6- VTAB 

OCj^g- Form feed 

ODj^g- Carriage return 

IB^fi- Escape 



Action 



Send to buffer 



Change to 40i6- 5Ei6 «f 

using a 64-character set, or 

leave unchanged if using a 
96-character set 

Print buffer, upspace one line, 
and terminate request 

Same as 03j[6 



Simulated TAB, send blanks to 
buffer 

Ignore 



Print buffer, select format tape 
level two, and continue printing 
from next print position 

Select format tape level one 
(top of form) and continue 
printing from next print position 

Print buffer, upspace one line, 
and continue printing from 
beginning of line 

Used for direct function control 
of the line printer 

The next character is 
interpreted as follows: 

00i6- Ignore 
2Fi6 

30jL6 Print buffer, no 

upspace, next line 
starts at the beginning 

31^5 Print buffer, single 
space, next line starts 
at the beginning 

32j^g Print buffer, double 
space, next line starts 
at the beginning 
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3326- Print buffer, select 
3E26 format tape level (01 
through 12), and 

continue printing from 
the next printing 
position 

3F26 Not applicable 

AOjg Clear controller and 
continue 

Aljfi- Ignore 
7Fi6 

aOjg- Print buffer, skip 
^'^16 0-65 lines, and continue 
printing from the next 
print position 

Tab stops for tab simulation are assumed to exist every n 
characters of the print line. Each time a tab character is 
encountered, sufficient space characters are sent to the 
print buffer to advance the character counter to the next 
tab-stop position. In the released version the tab stops are 
at 20, 40, 60, 80, 100, and 120. 

\Mien the 12-channel format tape selections are used, the 
line count is always reset to zero. Lines are counted when 
the non-FORTRAN FWRITE and WRITE modes are used. 



ERROR CONDITIONS 

The following errors are detected by the driver: 

O Internal or external reject 

• Hang-up 

• Alarm 

When the driver detects an irrecoverable failure, it sets the 
error field in bits 15 through 13 of word 9 of the physical 
device table for the device, sets the error word in the 
Q-register, and transfers control to the alternate device 
handler. Refer to the MSOS Diagnostic Handbook for I/O 
error codes and descriptions. 

1827-30/32/60/90 LINE 
PRINTER DRIVER 

This driver processes WRITE, FWRITE, and MOTION 
requests for the 1827 Line Printer. The driver is written in 
kernel format and is initially mass storage resident. There 
are no options in the driver; all modules must be included. 
Only one line printer can be handled by the driver. The 
driver provides FORTRAN format conversion. 

The driver communicates with the line printer exclusively 
on the A/Q channel. The driver will function in 
double-buffered mode provided bit of word 36 of the 
PHYSTB is set. The driver normally functions in pre-print 
mode. 



WRITE/FWRITE/MOTION 

The characteristics of these requests are discussed above. 

CHARACTER EDITING 

The character editing capability is discussed above. 

STATUS AND ERROR HANDLING 

The printer controller status bits are as follows: 



13 



12 11 10 9 8 7 6 5 4 3 2 1 



NOT USED 



BUFFER OVER- 
FLOW 



OUT OF PAPER . 

ADT MODE ■ 

PROTECT- 



i 



I_ 



READY 

BUSY 

INTERRUPT 

READY FOR DATA 

END OF OPERATION 

ALARM: OUT OF PAPER OR 

MALFUNCTION 
ERROR 



If an unrecoverable error occurs, it is reported by the 
alternate device handler (if any). The error fault value is 
returned in the A-register as well as being stored in word 9 
of the physical device table. Values are as follows: 



Code 


Definition 





Timeout 


2 


Alarm 


3 


Parity 


5 


Internal reject 


6 


External reject 


38 


Paper out 



NOTE 

A 96-character band may replace the 
standard 64-character band. In order to 
take advantage of the extended 
character set, bit 15 of word 36 of the 
physical device table must be set to one. 
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ITOS 2 1827-7 LINE PRINTER 
DRIVER 

This driver processes WRITE, FWRITE, and MOTION 
requests for the 1827-7 Line Printer. The driver is mass 
storage resident. There are no options in the driver; all 
modules must be included. More than one line printer can 
be handled by the driver. 

The driver communicates with the line printer through the 
1843-2 CLA. The line printer driver works as a pseudo 
driver since it reformats data intended for the printer, 
then makes a nonstandard MSOS 5 request to the 1843-2 
CLA driver indicating the CLA channel attached to the 
printer. 



1829-30/60 CARD READER DRIVER 



This driver processes READ, FREAD, and MOTION 
requests for the CB104 Card Readers. The CB104 Card 
Reader Driver is written in kernel format, and is initially 
mass storage resident. The input or motion requests are 
handled successively, rather than concurrently. 

The driver is Interrupt driven unless the operator selects 
the status-driven option. The status-driven feature is 
selected by changing two words in the physical device table 
for that card reader (see appendix C). INTBIT (word 33) 
contains deselecting bits as shown: 



WRITE/FWRITE/MOTION 

The characteristics of these requests are discussed above. 

CHARACTER EDITING 

Characters are edited as discussed above, except that the 
escape character (IB^g) when followed by ^^is- 
FFjg Is ignored. The 96-character set option is not 
available on this printer. 



PHYSTB 
IS 14 13 12 11 10 8 8 7 6 5 4 3 2 1 



deselects data 
"interrupt 

_ deselect eno-of- 
operation interrupt 

-deselects alarm interrupt 



STATUS AND ERROR HANDLING 

Printer controller status is not available. The status 
returned in the physical device table is the formatted 
status from the 1843-2 CLA driver. Bit assignment is: 



If any INTBIT is set, WAIT AD (word 34) must contain the 
absolute address of the status routine that checks 
completion of the I/O event. The kernel driver executes 
the routine and receives control after execution at the 
continuator entrance of the driver. Transfers are made in 
ADT mode. 



15 14 13 12 11 10 9 8 7 



4 3 





■SUBREQUEST 
CODE INTERNAL 
TO DRIVER 
PARITY ERROR 



- ILLEGAL REQUEST 
TIMEOUT 

FRAMING ERROR 

LOST DATA 
EXTERNAL OR INTERNAL REJECT 



DATA FORMATS 

The user may select either ASCII63 or ASCII68 conversion 
for ASCII reads. This is done by setting word 43 of the 
physical device table to (ASCn63) or 1 (ASCII68). The 
manual interrupt processor accepts CARD26 or CARD29 as 
a command to perform this function. 



READ BINARY 

The calling sequence specifies the number of words in 
memory to be filled, starting at a requested beginning 
address. Card columns are packed, leaving no unused bits. 
After reading in binary mode, the buffer appears as: 



If an error occurs, it is reported by the alternate device 
handler, and logged in the engineering file. Fault code 
values are as follows: 



Code 


Definition 





Timeout 


2 


Alarm/status 


3 


Parity 
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15 



12 11 



8 7 



4 3 



COLUMN 1 


COLUMN 2 


COLUMN 2 


COLUMN 3 


COLUMN 3 


COLUMN 4 


COLUMN 5 


COLUMN 6 


COLUMN 6 


ETC. 
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If zero words are requested, only the first column of the 
card is read. The unused bits are set to ones; the 
remainder of the card is unavailable. If a READ ends in 
the middle of a card, motion continues but the unread 
portion of the card is unavailable. 



READ ASCII 

Words in memory are filled, starting at a given address, 
until the number of requested w/ords is filled. READ ASCII 
proceeds in the same manner as READ binary except that 
each column is converted from Hollerith to a 7-bit ASCII 
equivalent before being stored. These ASCII characters 
are stored two per word, leaving bits 7 and 15 zero. If the 
number of words being read is zero, one column is read and 
the character is placed in the upper half of the word with 
ones placed in the lower half. See FREAD ASCII below for 
conversion code information. 



If the number of words requested is depleted prior to 
reading one card, the remainder of the card is unavailable 
and the read operation is in READ ASCII mode. 

If a binary card is read when an FREAD ASCII is specified, 
either the card is read in binary (the first card of a record) 
or a 7/9 punch error occurs (not the first card). The 
Hollerith code conversion to ASCII can be done using 
ASCII63 (026 type) or ASCII6B (029 type). 



EOF PROCESSING AND MOTION REQUESTS 

The card reader driver provides the capability of handling 
end-of-files. An end-of-file is a card with column 1 
punched with the configuration set into word 42 of the 
physical device table. Normally it is a 6/7/8/9 punch, 
therefore, PHYSTB word 42 contains OOOF15. 

The MOTION request to skip file forward is honored by the 
driver. All other MOTION requests cause no action. 



FREAD BINARY 

Although a formatted read operation may be specified with 
the request as binary or ASCII, the format of the card 
actually determines the mode. If column one of the card 
contains a 7/9 punch, it is read as a formatted binary 
record; otherwise, it is read as a formatted ASCII 
regardless of the mode specified in the request. 

Figure 5-1 is the format for the binary record cards. 

All cards within a record must have their sequence 
numbers in order. If a record requires multiple card 
storage and a sequence error is detected on any card within 
the record, the error is fatal and the alternate device 
handler is entered. 

If the cards are out of order and the reader stops for that 
status error, the operator presses the RESET button, 
making the card reader not ready. The operator then 
removes the remaining cards from the hopper, causing a 
hopper empty status condition. The out-of-order card is 
reinserted in the correct sequence and the remainder of 
the deck is read when the operator represses the RESET 
button (making the card reader ready). The card reader 
then reads the remainder of the deck, now properly 
sequenced. 

If the number of words requested is less than the length of 
the record, cards are passed with no data transferred until 
the entire format record is passed. 

If the number of words requested is greater than tlie length 
of the record, data transfer ceases at the end of the record 
and no further cards are read for that request. 

On a formatted binary card, row 8 of column 1 is the 
checksum override bit. When the driver detects this 
condition, a card's checksum is ignored. 



FREAD ASCII 

Columns are read to ASCII mode until either one entire 
card is read or the number of words requested is filled, 
whichever occurs first. 



STATUS AND ERROR HANDLING 

As discussed above, the operator has the option of driving 
the card reader from status information as well as from 
various interrupts. 

Actual status (director status 1 and director status 2) is 
saved on the initiator, continuator, and timeout entries. 
Separate locations in the physical device table save the 
latest status. This feature is available for the diagnostic 
logical unit, as well as for the nondiagnostic logical unit. 
In addition, a combined director status 1 and director 
status 2 is provided. The results are placed into word 
ESTAT2 (word 12) in the physical device table. Combined 
status is shown below: 



IS 14 13 12 11 10 9 8 7 







































STACKER JAM — 


_r 




























' READY 


FAILED TO FEED ' 


























BUSY 


STACKER FULL ' 
























INTERRUPT 


HOPPER EMPTY T"' 




















DATA 


END-OF-FILE ' 
















' END-OP-OPERATION 


ADT MODE 












' ALARM 


NOT READY 








LOST DATA 


RESE 


RVE 


D 


Fl 


OF 


If 


U 


Tl 


JP 


El 


ISE 








- 




PR 


OTEC 


T 


EC 


> 















A diagnostic logical unit is supported by the driver. Mien 
using the diagnostic logical unit, a maximum of one card 
can be read even if the user's request specifies a word 
count greater than one card. A zero word request updates 
the two director status words in the physical device table 
but does not feed a card. For a nonzero request, raw data 
(12 bits right-justified per word representing a card 
column) is stored in the user's buffer. A request saves a 
maximum of 80 words of raw data. Errors detected by the 
kernel driver are not handled by the alternate device 
handler. 
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FIRST CARD 





COLUMN 1 


2 


3 




12 

11 




/ 


E 






1 


A 




B 




2 






3 

4 








C 


5 




B 






ti 








7 










8t 






C 




9 


^ 






$ ^ 



SUBSEQUENT CARDS. 



12 
11 

1 
2 
3 
4 
5 
6 
7 
8 



COLUMN 1 


2 


3 






79 


80 


A 


E 










•> 








C 


C 


C 






D 


















D 



















WHERE: A IS THE SEQUENCE NUMBER (COLUMN 1, ROWS 12 THROUGH 5). 

B IS THE COMPLEMENTED RECORD LENGTH (COLUMN 2, ROWS 2 THROUGH 9; 
COLUMN 3, ROWS 12 THROUGH 5 ON THE FIRST CARD). 

C IS THE DATA (FIRST CARD STARTS IN COLUMN 3. ROW 6; OTHER CARDS START 
IN COLUMN 2, ROW 2). 

D IS A 16-BIT CHECKSUM (IT FOLLOWS THE LAST DATA WORD OF A RECORD). 

E IS RESERVED (COLUMN 2, ROWS 12 THROUGH 1). IT IS BLANK UNLESS A 

CHECKSUM OVERRIDE IS INDICATED IN COLUMN 1; OVERRIDING THE CHECK- 
SUM IS NOT RECOMMENDED. 



"•"if ROW 8 IN COLUMN 1 IS PUNCHED, THE DRIVER IGNORES THE CHECKSUM. 
2469 



Figure 5-1. Binary Format Record Cards 
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Timeout errors, bad status, internal rejects, and external 
rejects are reported in the physical device table. Detailed 
analysis of bad status is not performed. The fault code 
defining the error that has been detected is located in the 
physical device table, word 16. The possible fault codes 
are shown below: 



Code 



Definition 



Code 



4 
5 
6 
8 
9 
10 



Definition 



Timeout 



Lost data 

Bad initiator status (diagnostic 

logical unit) 

Alarm 

Bad continuator status (diagnostic 

logical unit) 

Checi<sum error 

Internal reject 

External reject 

Illegal Hollerith punch 

Sequence error 

Length error (formatted binary) 



12 


7/9 punch error 


lA 


Not ready 


22 


Staclcer full 


23 


Hopper empty 


24 


Feed failure 


25 


Card jam 


34 


Data status at end-of-operation 


35 


Premature end-of-operation status 


53 


No end-of-operation 


54 


No data status before end-of-operation 


61 


No interrupt status 


62 


Status shows ADT mode 


63 


Busy after end-of-operation 


64 


No busy before end-of-operation 
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DRIVER DESCRIPTIONS AND DATA FORyATS 
FOR MAGNETIC TAPE DRIVERS 
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MAGNETIC TAPE DRIVERS 



Magnetic tape drivers process the standard 
READ/WRITE/FREAD/FWRITE/MOTION requests. A data 
transfer can be accomplished with one of the three types 
of transfer modes: buffered, unbuffered, and auto-data 
transfer (ADT). During an unbuffered transfer, interrupts 
are inhibited to prevent lost data. Interrupts are enabled 
during the other types of transfers. 



DATA FORMATTING 

Magnetic tape drivers can transfer data to seven- or 
nine-track tape drives. Data on nine-track devices 
requires no special handling. All data is written in odd 
parity and no code conversion is rquired. Two parity error 
checi<s, LRC (logitudinal redundancy check), and CRC 
(cyclic redundancy check) are used for verification. They 
are transparent except to the driver. One computer word 
comprises two data frames on tape. 

Data transfers on seven-track drives require special 
processing. There are only six data bits in each frame; 
therefore, internal ASCII data is converted to external 
BCD, a six-bit code, when data is to be written to tape. 
The reverse process is used on read transfer - BCD to 
ASCII conversion. 

Binary transfers on seven-track drives also require 
additional reformatting. The hardware 

assembly/disassembly utilizes only the six least significant 
bits of each half word. Therefore, prior to an output 
transfer, data is reformatted to conform to this 
requirement. On input, a reverse procedure is performed. 
The reformatting of the data is performed in a buffer area 
different from the user buffer. This repacking buffer must 
also be bigger than the user's buffer. Therefore, a 
maximum buffer size limitation must be imposed on the 
user buffer length. The release software provides a buffer 
that allows the user to specify a maximum record size of 
192 words. 



FORMATTED REQUESTS 

The FREAD and FWRITE requests are handled as single 
record requests; one request for one physical record. The 
maximum record size limitation for seven-track drives is 
enforced. Any length in excess of this maximum is 
truncated. No length restriction applies to nine-track 
drives. When the record is shorter than the requested 
length in reading operations, the short read indicator is set 
and the address of the last location containing data is 
placed in the last word of the user's buffer. 
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UNFORMATTED REQUESTS 



'mmi^ 



READ and WRITE requests are handled as logical record 
requests. A logical record length is that number of v/ords 
defined in the user's parameter list. However, if that size 
exceeds the maximum size allowable on seven-track drives, 
the driver breaks up the logical record into several physical 
tape records. 

For READ requests on either seven- or nine-track, one 
logical record may be one or more physical record. The 
driver continues reading records until the user's buffer is 
filled or until a file mark is encountered. 



MOTION REQUESTS 

Tape drivers perform all of the normal motion commands. 
Special handling is performed on a rewind request. When a 
tape is rewinding, the subsystem is capable of performing 
data transfers on other drives. Therefore, the interrupt is 
not selected on the rewind operation. Instead, a status 
checking routine is scheduled at priority 3. When a load 
point condition is detected, the driver's initiator entry is 
scheduled. 



ERROR RECOVERY 

The recovery procedure provides a uniform recovery 
alogrithm for magnetic tape controllers. 



Software Requirement 

The magnetic tape drivers provide a capability for 
maximum recovery by utilizing noise records. A system 
noise record is defined in size and marks off a bad spot of 
up to two words on the tape; it is used as an aid for error 
recovery. 

During a read operation the length and parity of the record 
are checked first. If there is no parity error and the record 
length is that of a system noise record, the record is 
assumed to be standard noise record and is discarded. 
Another read is then issued to fulfill the user's request. 

The standard noise record reduces the likelihood that 
unerased noise will cause a read error. Standard noise 
records absorb small amounts of noise and cause the driver 
to discard them. Without standard noise record the 
unerased noise would be merged with the following record, 
causing an incorrect or irrecoverable read. 
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Switched Mode 

When a read error recovers by switching the mode of 
operation, the V-field bits are set (bits 15 through 13), 
resulting in Q being set negative upon return to the 
requester. The data read is not placed in the requester's 
buffer. The tape is positioned after the last record read. 



NOTE 

It is the user's responsibility to 
backspace the record and issue a new 
request in the opposite mode to obtain 
data. 



There is no logical diagnostic unit for the LCTT; instead 
the alternate device handler has the ability to report failed 
device errors. 

The LCTT driver operates in the buffered data mode; data 
transfers using ADT and A/Q are not supported. Tape 
recording density is 800 bpi. Neither reverse read nor 
nonstop read capability are present. 

All transfers are timed by a diagnostic clock. Failure of 
the transfer to complete in the allotted time triggers the 
timeout error (and recovery) logic. 



DATA AND RECORD FORMAT 



Successful Recovery 

On a read function the data is passed to the user as if it 
were an error-free read. The write function passes control 
back to the user as if no error had occurred. 



Unsuccessful Recovery 

Control is never given back to the user without operator 
intervention; it goes to the alternate device handler where 
the appropriate message and code are typed. The message 
format and code are as follows: 

L,lu FAILED ec 

Where: 

lu is the logical unit number. 

ec is the error code from the alternate device 
handler. 

Operator response: 

RP Repeats the request 

CU Allows the processing to continue 

DU Suspends any further processing 

1860-3/4 LOW-COST TAPE 
TRANSPORT 

The low-cost tape transport driver processes READ, 
WRITE, FREAD, FWRITE, and MOTION commands for the 
LCTT. Several tape units may be controlled at the same 
time; however, only one request is executed at a time. A 
single copy of the LCTT driver can control several LCTT 
units even though the units may have differing 
characteristics. 

If only nine-track units are present, modules TK7 and 
TK7DAT can be omitted. Seven-track capability requires 
module TK7. ASCII converson and binary reformatting for 
seven-track tapes requires module TK7DAT also. 

If recovery capability is desired, the module RECVRY 
must be included. If raw hardware status rather than 
composed status is desired, the module FORMIT may be 
omitted. 



Data Format 

Nine-Track Data Transfers - The basic transfer 
(nine-track) does not need reformatting. All data transfers 
on a nine-track LCTT are treated as binary and are 
recorded in odd parity at 800 frames per inch (fpi). Two 
8-bit tape characters (frames) compose a single CPU 
word. ASCII is transferred without conversion. The data 
in memory corresponds to the data on tape and is packed as 
shown: 



15 




8 


7 







FRAME 1 


FRAME 2 


FRAMES 




FRAME 4 




FRAMES. 


FRAME 6 



Seven-Track Data Transfers - This option requires the TK7 
module. If there is no module TK7DAT in the system, data 
is transferred to and from memory without conversion. 
Since the hardware operates in assembly/disassembly mode 
only, the data appearance in main memory (both ASCII and 
binary) is as shown: 



15 


14 


13 




8 


7 


6 


5 











FRAME 1 








FRAME 2 








FRAME 3 








FRAME 4 








FRAME 5 








FRAME 6 



Bits 6, 7, 14, and 15 must be zero whether reading into or 
writing from memory. If any of these bits are set during a 
write-to-tape operation, a hardware program error occurs. 
This error appears in the V-field as a short record error. 
For raw data transfers, the logical record length is defined 
by the 15-bit parameter n of the request. 

If the module TK7DAT is included, seven-track converted 
data transfers are available. Binary data is packed or 
unpacked in main memory; ASCII data is converted to or 
from external binary coded decimal (BCD). 
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Seven-track binary mode assumes data to have the 
following format: 



15 13 


12 


11 10 


9 8 


7 6 


5 


4 3 


2 


FRAME 1 


FRAME 2 


FRAME 3 


FRAME 3 


FRAME 4 


FRAME 5 


FRAMES 


FRAMES 


FRAME? 


FRAME 8 



Seven-track ASCII mode causes the ASCII data in memory 
to be converted to or from external BCD. The ASCII 
characters in memory correspond to the BCD tape form as 
shov/n: 



15 




8 


7 







FRAME 1 


FRAME 2 


FRAME 3 


FRAME 4 


FRAME 5 


FRAMES 



For seven-track requests, the maximum length of a 
physical record is set to the physical record size parameter 
(PHSREC) to limit core use. (PHSREC is 192 words for 
this discussion.) If a logical record is longer than PHSREC, 
it is segmented and written as a series of physical records. 
An analogous procedure is used for reading a logical 
record. For raw data transfers, the record size is limited 
only by the 15-bit parameter n of the request. Any unused 
portion of the last physical record is lost on subsequent 
read operations. 



FREAD/FV/RITE records 



The formatted seven-track 
the physical record, with all 



requests are oriented to 

records defined to be the same PHSREC length (usually 192 

words). Any record longer than that is truncated. 

The formatted nine-track requests are not similarly 
restricted. Instead, the user defines the logical record 
length. For FREAD operation, the driver stops at the first 
physical record gap encountered. If the physical record is 
larger than the number of words requested, only the 
number requested is placed in memory. If the number 
requested is greater than the physical record size, the 
short read indicator is set. The record may be a file mark, 
in which case file mark status is indicated. 



Record Constraints 

READ/WRITE records - Record lengths for nine- and 
seven-track LCTTs are defined by the requestor; the 
number of words specified in a READ/WRITE request 
defines a logical record. 

For nine-track write requests, a logical record is written as 
a physical record. For read requests, the user defines the 
logical record as any length that is unrelated to the length 
of the physical record. The driver reads through record 
gaps until the logical record is complete or until it 
encounters a file mark. 



READ/WRITE/FREAD/F=WRITE 

The calling sequence and parameter lists for these requests 
are described in section 1. At execution time, the external 
indications are also the same as those described in that 
section. However, SYSDAT must contain a buffer for 
seven-track data conversion (if TK7DAT is included). The 
size of this buffer (which is defined at assembly time) is 
(PHSREC X 4/3) + 2. Note that the buffer must be large 
enough to accommodate the maximum record size as 
defined by PHSREC. 

The use of buffers for the four acceptable transfer 
requests is shown in table 6-1. 



TABLE 6-1. USE OF BUFFERS FOR READ, FREAD, WRITE, FWRITE REQUESTS 









9-Track and 7-Track without 






7-Track with S18326 (LCn/FORMAHER) 


TK7DAT (LCn) or without 


Request 


Mode 


7-Track with TK7DAT (LCH) 


S18326 (LCTT/FORMATTER) 


READ 


Binary 


LCTT — PHYSTB buff er.— packed 4 to 3 into 


LCTT— -requestor's buffer 


or 




requestor's buffer 




FREAD 










ASCII 


LCTT— ^PHYSTB buffer; convert external 
BDC to ASCII in place — ►requestor's buffer 


LCTT— requestor's buffer 


WRITE 


Binary 


Requestor's buffer — ►unpacked 3 to 4 into 


Requestor's buffer— LCTT 


or 




PHY STB buffer^^LCTT 




FWRITE 










ASCII 


Requestor's buffer — ►PHYSTB buffer; convert 
ASCII to external BCD in place — ►LCTT 


Requestor's buffer — ►LCTT 
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MOTION 

The calling sequence and parameter list for the MOTION 
command are as shown in section 1, except that the dy 
parameter in word 4 always is zero. The pi, p2, and p3 
codes are executed from left to right. The codes are: 

Code Definition 

First zero terminates request 

1 Backspace record 

2 Write file mark 

3 Rewind to load point 

4 Rewind and unload 

5 Advance one file 

6 Backspace and erase file 

7 Advance record 

If a motion is to be repeated, word 4 of the MOTION 
request is: 



15 14 12 11 



WORD 4 



1 


pCODE 


n ' NUMBER OF REPEATS 



Read operations are as follows: 

1. Attempt to reread the data several times using 
normal, high, and low signal clipping levels. 

2. Reset parity mode. 

3. Indicate an unrecoverable error because there are 
parity errors or the number of allowable retries has 
been exhausted. 



If the composite status option (FORMIT) is included, word 
12 of the physical device table for an LCTT (see 
appendix C) indicates the status bits shown below: 



15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 



WRITE I 
ENABLE ' 

SEVEN TRACK — 

800 FPI 

556 FPl : 

FILE MARK 

NOISE RECORD BYPASSED 

END OF TAPE 
PARITY ERROR 



11 



READY> 
BUSY 

RECOVERED ERROR 

IRRECOVERABLE ERROR 

NOT USED 

ALARM 

LOST DATA 

NOT USED 



where n is the number of repeats, n must be 4095 or less. 

If a load point is detected during execution of a backspace 
request, an alarm is indicated and tape is ready at load 
point. 



This is not the actual hardware status but is a composed 
status formed by the driver module called FORMIT based 
on the information supplied by the hardware status and 
word 24 (unit/mode) in the physical device table. 

There is no diagnostic logical unit capability in the LCTT 
driver. Instead, the alternate device handler sends error 
messages concerning the failure to the comment device. 
Values for the alternate device fault code are as follows: 



ERROR RECOVERY 

If the error recovery option (RECVRY) is included, the 
driver attempts to correct errors using the standard CDC 
tape recovery techniques. These include v/rite and read 
operations. 



^ite operations are as follows: 

1. Back over the area just used, erasing and rewriting. 

2. Verify the rewa'itten information. 

3. Indicate an unrecoverable error because tape has run 
out, a good block (record) on tape has not been found, 
allowable number of consecutive erasures has been 
exceeded and erase error has occurred, or the block 
just written has not been identified. 



Code 


Definition 





Logical unit timed out 


1 


Lost data 


2 


Alarm 


3 


Parity 


13 


No write ring on write request 


14 


Not ready 


15 


Noise record was bypassed 


31 


Short record requested (less than three words) 


41 


Incomplete error (unrecoverable) 
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1860-5/6 LOW-COST TAPE 
TRANSPORT/ FORMATTER 
DRIVER (DUAL MODE) 

The LCTT/formatter driver processes READ, WRITE, 
FREAD, FWRITE, and MOTION commands for the 
LCTT/formatter. Several tape units may be controlled at 
the same time; however, only one request is executed at a 
time. A single copy of the LCTT/formatter driver can 
control several LCTT units even though the units may have 
differing characteristics. 

If only nine-track units are present, the S18326 module can 
be omitted. Seven-track capability requires the S18326 
module. 

If recovery capability is desired, the module R18326 must 
satisfy the appropriate conditional assembly. 

The LCTT/formatter driver uses the DSA channel for data 
transfer and the A/Q channel for its other functions. It 
supports nonstop read and nonstop write. Densities allowed 
are 800 or 1600 frames per inch (fpi) for nine-track units, 
and 556 or 800 fpi for seven-track units. All transfers are 
timed by a diagnostic clock. Failure of the transfer to 
complete in the allotted time triggers the timeout 
error/recovery logic. 

DATA FORMAT 

Nine-Track Data Transfers - The basic transfer 
(nine-track) does not need reformatting. All data transfers 
on a nine-track LCTT/formatter unit are treated as binary 
and are recorded in odd parity at 800/1600 fpi. Two 8-bit 
tape characters nine frames) compose a single CPU word. 
ASCn is transferred without conversion. The data in 
memory corresponds to the data on tape and is packed as 
shov/n: 



Bits 6, 7, 14, and 15 must be zero whether reading into or 
writing from memory. If any of these bits are set during a 
write to tape operation, a hardware program error occurs. 
This error appears in the V-field as a short record error. 
For raw data transfers, the logical record length is defined 
by the 15-bit parameter n of the request. 

If the module S18326 is included, seven-track converted 
data transfers are available. Binary data is packed or 
unpacked in memory; ASCII data is converted to or from 
external BCD. 

Seven-track binary mode assumes memory data to have the 
following format: 



15 13 


12 


11 10 


9 8 


7 6 


5 


4 3 


2 


FRAME 1 


FRAME 2 


FRAME 3 


FRAMES 


FRAME 4 


FRAMES 


FRAMES 


FRAME 6 


FRAME 7 


FRAME 8 



Seven-track ASCII mode causes the ASCII data in memory 
to be converted to or from external BCD. The ASCII 
characters in memory correpond to the BCD tape frame as 
shown: 



15 




8 


7 







FRAME 1 


FRAME 2 


FRAME 3 


FRAME 4 


FRAME 5 


FRAMES 



15 




8 


7 







FRAME 1 


FRAME 2 


FRAME 3 


FRAME 4 


FRAMES, 


FRAME 6 



Seven-Track Data Transfers - This option requires the 
S18326 module. If the module is not in the system, data is 
transferred to and from memory without conversion. Since 
the hardware operates in assembly /disassembly mode only, 
the data appearance in memory (both ASCII and binary) is: 



IS 


14 


13 


8 


7 


6 


S 











FRAME 1 








FRAME 2 








FRAME 3 








FRAME 4 








FRAME S 








FRAME 6 



RECORD CONSTRAINTS 

READ/WRITE records - Record lengths for nine- and 
seven-track LCTT/FORMATTER units are defined by the 
requestor: the number of words specified in a 
READMRITE request defines a logical record. 

For nine-track write requests, a logical record is written as 
a physical record. For READ requests, the user defines the 
logical record as any length that is unrelated to the length 
of the physical record. The driver reads through record 
gaps until the logical record is complete or until it 
encounters a file mark. 

For seven-track requests, the maximum length of a 
physical record is set to PHSREC to limit core use. 
(PI-ISREC, the physical record size parameter, is 192 words 
for this discussion.) 

If a logical record is longer than PHSREC, it is segmented 
and written as a series of physical records. An analogous 
procedure is used for reading a logical record. For raw 
data transfers, the record size is limited only by the 15-bit 
parameter n of the request. Any unused portion of the last 
physical record is lost on subsequent read operations. 
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FREAD/FWRITE records - The formatted seven-track 
requests are physical record oriented, with all records 
defined to be the same PHSREC length (usually 192 
words). Any record longer than that is truncated. 



If a motion is to be repeated, word 4 of the MOTION 
request is: 



The formatted nine-track requests are not similarly 
restricted. Instead, the user defines the logical record 
length. For FREAD operation, the driver stops at the first 
physical record gap encountered. If the record contains 
more words than requested, only the number requested is 
placed in memory. If the record contains fewer words, the 
short read indicator is set. The record may be file mark, in 
which case, file mark status is indicated. 



READ/WRITE/FREAD/FWRITE 

The calling sequence and parameter lists for these requests 
are described in section 1. At execution time, the external 
indications are also the same as those described in that 
section. However, SYSDAT must contain a buffer for 
seven-track data conversion if S18326 is included. Size of 
this buffer, which is defined at assembly time, is 
(PHSREC X 4/3) +2. Note that the buffer must be large 
enough to accommodate the maximum record size as 
defined by PHSREC. 



The use of buffers for the four acceptable transfer 
requests is shown above in table 6-1. 



MOTION 

The calling sequence and parameter list for the MOTION 
command are as shown in section 1, except the dy 
parameter in word 4 is always zero. The pi, p2, and p3 
codes are executed from left to right. The codes are: 



IS 14 12 11 



Code 



Definition 



WORD 4 



1 


pCODE 


n - NUMBER OF REPEATS 



First d terminates request 



If a load point is deleted during execution of a backspace 
request, an alarm is indicated. 

The number n must be 4095 or less. 



ERROR RECOVERY 

If the error recovery option R18326 is included, the driver 
attempts to correct errors using the standard CDC tape 
recovery techniques. These include: 

Vfrite Operations; 

1. Back over the area just used, erasing and rewriting. 

2. Indicate an unrecoverable error due to running out of 
tape, or being unable to find a good block (record) on 
tape, or exceeding the allowable number of 
consecutive erasures, or an erase error occurring. 

Read operations: 

1. Attempt to reread the data several times using 
normal, high, and low signal clipping level levels. 

2. Reset parity mode. 

3. Indicate an unrecoverable error due to parity errors or 
to exhausting the number of allowable retries. 

The status bit assignment is: 



Backspace record 



Write file mark 



Rewind to load point 



Rewind and unload 



Advance one file 



6 Backspace and erase file 



IB 14 13 12 11 10 987654321 







































BUSBtJSY- 


J 




























L 


— READY 


CONTROLLER 
PROTECT 




























— BUSY 


NOT USED ' 




















' INTERRUPT 


ON-eus — J 




















' ALARM 


FILE MARK ' 
















' NOT USED 


NOT USED 1 












' NOT USED 


END OF TAPE 1 








1 NOT USED 






1 


EN 


D 


O 


F( 


3F 


€ 


n/ 


IT 


IG 


M 




J 




1 





NC 


)T 


US 


E 


D 

















Advance record 
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Meanings of the fault codes are: 



Fault 
Code 


Failure 





Lu times out 


1 


Lost data 


2 


Alarm 


3 


Parity 


5 


Internal reject 


6 


External reject 


13 


No write ring on write request 


14 


Not ready 



Fault 

Code Failure 

31 Short record requested (less than two words) 

32 Tape defect 

36 Transmission parity error 

50 No ID burst 

51 Illegal density, or an attempt to change 
density when tape not at load point 

60 Illegal motion code 

84 Bus relinquished 

86 Switch mode error 

87 No character read in 25 feet (7.6 meters) 



96769390 F 



6-7 



OPERATING SYSTEM DRIVERS 
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The drivers specified in this section are part of the 
MSOS3.Q package and are included in this manual as a 
convenience to the user. These drivers are not necessarily 
available or desirable in all systems. Refer to the 
appropriate system reference manual for additional 
Information. 



unprotected file. The file must be defined, opened, and so 
forth, using: 

♦DEFINE 

*OPEN 

♦CLOSE 

♦RELEAS 

♦PURGE 

♦MODFY 



DUMMY DRIVER 



The dummy driver performs no physical Input/output. When 
the dummy driver is defined as an alternate, it completes 
failed I/O requests that have an error indication without 
operator intervention. The dummy driver also restores the 
failed device to an ip condition. This technique is always 
used to prevent system hang-ups on the standard comment 
device. Programs should always checi< for I/O errors at 
their completion address and take appropriate action when 
errors occur (bit 15 of the Q register equals 1). 

The dummy driver logical unit can also be used in placexof 
any other system logical unit. In this case, the I/O request- 
is completed with no error. This facility is useful for 
slewing through records. 



These statements cause the necessary initialization of the 
pseudo-tape physical device table. After this set-up 
process, the devices may be accessed as normal magnetic 
tapes, with the exception that the first EOF terminates the 
pseudo tape and write is always enabled. 

Foreground pseudo tapes function in the same way as 
background pseudo tapes, except that the user does not 
need to use *DEFINE, *OPEN, and so forth to set up the 
tape for use. 



COSY DRIVER 



The COSY driver is actually a COSY compress/decompress 
module. Input through this driver is from the standard 
COSY input unit; output is to the standard COSY output 
unit. 



PSEUDO-TAPE DRIVER 



The pseudo-tape driver drives pseudo devices that have the 
external characteristics of a magnetic tape. The pseudo 
devices are sequential files that are created_and acceded 
by the driver for calls to the file manager. Usirjg^job 
control statements several set-up operations"must be 
performed prior to using pseudo tapes from the 



SOFTWARE BUFFER DRIVER 



The software buffer driver is capable of improved memory 
utilization in situations where programs require data 
output to system devices that are classified as having slow 
data rates (for example, I/O-TTY, paper tape punch, and so 
forth). 
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SYSTEM INITIALIZER DRIVERS 
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The system initializer requires device drivers for many of 
the peripherals. One driver of any device type may be 
present in a given system initializer. The drivers in the 
system initializer do not use interrupts but operate the 
devices on the basis of the device status condition. In this 
mode of operation, device operation and timing may differ 
from the interrupt-driven driver. The logical units used by 
the initializer are predefined in the range 1 through 8. The 
minimum initializer requirement is an input driver, 
comment driver, and mass-memory driver. Dummy 
routines are provided to satisfy external linkages for 
missing routines. Table 8-1 defines the logical units, driver 
names, devices supported, and dummy names. 



DRIVER OPERATION 



INPUT DRIVERS 

The input drivers are controlled by the input driver 
interface, IDRIV. IDRIV calls the device driver by means 
of a return jump instruction that passes the follow/ing to 
the driver: 

9 A register - The buffer first word address for read 

Q register - The number of words to be read 

The driver returns to IDRIV with the error indicator (0 for 
error and 1 for no error) in the A register. If an error 
occurred, the following error information will be passed: 

• Q register - The error code 

• I register - The last hardware status 



TABLE 8-1. HARDWARE DEVICE DRIVERS 



Logical 
Unit 


Driver 
Name 


Hardware 
Devices 


Equipment 
Code/WES 


Dummy 
Name ' 


Other 
Requirements 


2 


QCARD 


1829-30/60 


11/0581 


QCDDMY 




3 


Q18326 


1860-5/6 


9/0480 


QMTDMY 


Unit used 


3 


QMLCT7 


1860-3/4 


9/0480 


QMTDMY 


Unit used 


3 


QMLCT9 


1860-3/4 


9/0480 


QMTDMY 


Unit used 


4 


Q18331 


1867-10/20/40 


14/0700 




Unit used 


4 


Q18334 


1866-14 


14/0700 




Unit used 


4 


Q8331I 


1867-10/20/40 


14/0700 




Unit used 


4 


Q8334I 


1866-14 


14/0700 




Unit used 


6 


Q1810 


1810-1 


1/0091 






7 


Q1827 


1827-30/32/60/90 


7/201 


QPRDMY 




7 


Q18277 


1827-7 


7/201 






8 


dummy"*^ 










"^Used to 


allow linkage of 


jnused driver entry poin 


ts 






''Used wlie 


1 no device actio 


1 is desired 
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MASS-MEMORY DRIVERS 

The mass-memory drivers are controlled by the 
mass-memory driver interface, MDRIV. MDRIV calls the 
device driver by means of a return jump instruction that 
passes the following to the driver: 

• A register - If set positive, buffer first word 

address; if set negative, write 
address tags (disl< only) 

• Q register - If set positive, number of words to be 

read; if set negative, complement of 
the number of words to write 

• I register - The starting sector address 



The driver exits with the error indicator (0 for error and -0 
for no error) in the A register. If an error occurred, the 
following error information is passed: 

• Q register - The error code 

• I register - The last hardware status 



DRIVER ERRORS 

The IDRIV module of the initializer reports device failures 
on the initializer comment device as: 

L,xx FAILED yy (zzzz) 
ACTION 

Vfriere: 

XX is the failed logical unit 

yy is the error code (the same as for regular 
drivers) 

zzzz is the last hardware status 

The response to the error takes one of two forms: 

• RP - Repeat the operation 

• CU - Abort the operation and return to the 

comment unit for a subsequent control 
statement 
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DISK-TO-TAPE UTILITY DRIVERS 
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These drivers transfer data between disk and tape. 
Transfer may be made in either direction. The transfer 
starts to/from the tape at the current file mark, and on 
input runs to the end of tape. Transfer from disk starts at 
the beginning and runs to the designated sector. Transfer 
to disk starts at the beginning and runs to the end of the 
tape records. After transfer, the option to verify the data 
on the two storage media is provided. 

There are three types of input/output subroutines used in 
the DSKTAP utility: magnetic tape, mass memory, and 
comment devices. 

The comment device driver is called: 

RTJ CDRIVE 

The A register contains the data buffer address. The Q 
register contains the length of the data buffer for an 
output or zero for an input request. 

Input/output on mass memory is performed by a call to 
MDRIVE: 

RTJ MDRIVE 

The A register contains the data buffer address, and the Q 
register equals the positive word count for a read and the 
negative word count for a write. 

To read data from magnetic tape, a call to MGREAD is 
made: 

RTJ MGREAD 

The A register Is equal to the buffer address, and the Q 
register is equal to zero. 

To write data to magnetic tape, call MGDRIV: 

RTJ MGDRIV 

The A register is equal to the buffer address, and the Q 
register is equal to the number of data words. If the A 
register is equal to zero upon entry to MGDRIV, an end of 
file is written on the tape and the unit is rewound. 



Errors can be detected by the calling program by testing 
the A register to see if it is equal to zero on return from 
the input/output routines. 



MSOS uses the following DTLP drivers. 



DSKCDR DECK-ID Dll DRIVERS 1.4C 
(comment device) 

MDRSMD DECK-ID C94 DRIVERS 1.4C 
(module drive) 

CDDRVM DECK-ID D63, DRIVERS 1.4C 
(cartridge disk drive) 

DTLCM7 DECK-ID C45 DRIVERS 1.4C 
(1860-3/4 mag tape) 

DTLCM9 DECK-ID C46 DRIVERS 1.4C 
(1860-3/4 mag tape) 

M18326 DECK-ID D79 DRIVERS 1.4C 
(1860-3/6 mag tape) 



IT OS uses the following DTLP drivers. 



DSKCDR DECK-ID Dll DRIVERS 1.4C 
(comment device) 

SMDMDR DECK-ID P15 DRIVERS 1.4C 
(module drive) 

CDDRVE DECK-ID U40 DRIVERS 1.4C 
(cartridge disk drive) 

DTLCT9 DECK-ID U41 DRIVERS 1.4C 
(1860-3/4 mag tape) 

M8326I DECK-ID U42 DRIVERS 1.4C 
(1860-5/6 mag tape) 
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SYSTEM CHECKOUT DRIVERS 



B18331 (SMD) AND B18334 (CDD) CONSTRAINTS 

B18331 (SMD) and B18334 (CDD) are memory-resident • Memory image must be less than 32768 (sector). 

drivers, which are used by the system checkout program to 

copy the memory image to a section of the disk defined in ® MSIZV4 must be less than $FFFF. 

SYSDAT. They are entered via a direct jump to COBOP. 

At termination the Q register contains a zero for © Routines have no recovery capability. 

successful completion. $FFFF in the Q-register indicates 

an error. 
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A register 

A CPU register used for addition. It is also used for 
one-word input/output transfers. 

Absolute address 

1. An address that is permanently assigned by the 
machine designer to a storage location 

2. A pattern of characters that identifies a unique 
storage location without further modification 

3. Synonomous with machine address, specific address 

Address 

1. An identification, as represented by a name, label, 
or number, for a register location in storage or any 
other data source or destination, for example, the 
location of a station in a communication network 

2. In general, any part of an instruction that specifies 
the location of an operand for the instruction 

Advance file 

Command to magnetic tape to advance tape until the 
next file mark is found 

ADT 

Auto data transfer - an I/O mode that allows A/Q 
transfers to be made in blocks as if a buffered transfer 
were undertaken. ADT mode drivers notify the 
requesting program only when the end-of-block transfer 
mark interrupt occurs. Micro interrupts for each A/Q 
transfer are treated internally by the driver. 



Alarm 
1. 



2. 



Error signal in the status word, usually indicating a 
serious hardware malfunction 

An audible signal, like that sent to an interactive 
terminal 



Alternate device handler 

A driver for an alternate hardware device. An 
alternate device is used for I/O transfer when an 
unrecoverable error occurs on the scheduled I/O 
device. The alternate device handler usually also 
processes the error indications for the device that 
failed. 

A/Q channel 

A Control Data CYBER 18 data channel that can handle 
input/output only through the A register 



Back read 

A magnetic tape command that causes magnetic tape 
to be read in the reverse direction 

Backspace 

A magnetic tape command that causes magnetic tape 
to be wound in the reverse direction for the number of 
records specified 



Batch 

In MSOS, an object program running in a stacked job 
manner that shares the CPU with the priority program 
when a priority program is present and executes only 
when the priority program is not in control of the 
processor. Batch interrupts have lowest priority in the 
interrupt processing priority scheme. 



Batch processing 

Pertaining to the technique of executing a set of 
computer programs so that each is completed before 
the next program of the set is started. Batch jobs are 
not considered to be time-critical since they no not 
need a particular response time (batch jobs have the 
lower priority). 

BCD 

Binary coded decimal 

Binary mode 

A method of reading data one binary bit at a time. 
Binary readouts are given in BCD or hexadecimal 
format for CYBER 18 data. 

Block 

Consecutive machine words or characters considered or 
transferred as a unit, particularly applicable to 
input/output 

Bootstrap 

A technique or device designed to bring itself into a 
desired state by means of its own action; for example, a 
machine routine whose first few instructions are 
sufficient to bring the rest of itself into the computer 
from an input device. 



BOT 



Beginning of (magnetic) tape. A physical mark on the 
tape 



Buffer 

1. A routine or storage used to compensate for a 
difference in rate of flow of data or time of 
occurrence of events when transmitting data from 
one device to another 

2. An isolating circuit used to prevent a driven circuit 
from infuencing the driving circuit 



Buffered data 

Data that is transferred via the I/O channel using the 
buffered data channel 



Buffered data channel 

The high speed I/O transfer channel for CYBER 18 
systems. Buffered data controllers transfer blocks of 
data. Micro interrupts are handled by hardware or 
firmware without driven intervention. 
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Character mode 

A data buffering mode in which the basic byte is usually 
a 7-bit ASCII character plus a parity bit 

Checksum 

A summary of digits or bits used primarily for checking 
purposes and summed according to an arbitrary set of 
rules 



Diagnostic logical unit 

A logical device devoted to detecting hardware errors. 
Many physical devices will have two logical unit 
identifications: a main logical unit identification for 
data transfer purposes, and a diagnostic logical unit 
identification for checking data transfer quality and 
storage. Each logical unit has its own physical device 
table. 



Completion priority 

A field in the standard I/O request parameter list. It 
designates the priority to returning control to the 
requestor after the task is completed. 

Continuator entrance 

An entrance to a program used to return control after a 
request has been completed 

Control point 

A boundary for main memory. Control point is a 
necessary parameter for 16-bit addressing in main 
memory when the main memory is larger than 65K 
words. MSOS 5 requests do not need control point 
parameters since the location of the request is a saved 
value. 



Controller 

A hardware device that controls access 
transfer to I/O units that are connected to it 



and data 



COSY 

A compress/decompress . module used to maintain 
programs 

CPU 

Central processing unit 

CRC 

Cyclic redundancy check - a hardware or firmware 
generated check code. It is stored on mass storage 
following the data and is returned with data read from 
mass storage. It is used for error checking to define 
data quality. 

CYBER 18 

A series of CDC minicomputer systems. 

Cyclic redundancy check 
See CRC 

Cylinder 

A set of tracks on a multisurfaced disk pack. Each 
track in a cylinder is on a different disk pack surface 
and lies above/below all other tracks on the same 
cylinder. The read/write heads are simultaneously 
positioned over all tracks in a single cylinder. 



Data packing 

A method of storing data within a data word to 
minimize unused bits, for example, packing 6-bit bytes 
into a 16-bit word would cause eight bytes to be packed 
into three words. (If the data was not packed, this 
would require one word per byte or per two bytes.) 
Bytes would be split between words and 1 and 
between words 1 and 2. 



Diagnostic timer 

A clock value set at the start of I/O transfers. If the 
requested operation has not completed before the 
preset time elapses, an error is declared and the driver 
initiates recovery/abort routines to terminate the 
request. 

Disk 

A mass storage device consisting of a controller and 
one or more disk packs each v/ith one or more rotating 
surfaces for storing data. One movable pair of heads 
(read/write) is provided for each surface. These heads 
read or write data to a single track at a time. 

Diskette 

A single-surface flexible disk pack 

Driver 

A program whose main function is to perform a physical 
I/O transfer of data between one storage medium and 
another (for example, between central memory and 
mass storage, between central memory and magnetic 
tape) 

DSKTAP 

A disk-to-magnetic tape module 

DTLP 

A disk-to-magnetic tape module 

Dummy driver 

A routine substituting for a driver that has substantive 
tasks to perform. The sole function of a dummy driver 
is to return control to the calling module. 



ECC 

Error correction code. A data quality checking code 

Engineering file 

A software controlled error logging file that stores 
information on hardware failures. An unrecoverable 
I/O error is usually logged in the engineering file. 

EOF 

End-of-flle 

EOP 

End-of-operation 



EOT 

End of (magnetic) tape, 
end of usable tape 



A physical mark locating the 



Error entrance 

An entrance to a program used to return control after 
an external request has failed 
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Error recovery 

Software that attempts to use data checks and special 
techniques to complete malfunctioning I/O transfers. If 
the recovery techniques succeed, no indication of an 
error is usually given to the requester. If the recovery 
techniques fail (unrecoverable error), the user program 
is often notified, the transfer is usually attempted on 
the alternate device (if any), and the error may be 
logged in the engineering file. 

ETX 

End-of-text 

External reject 

Reject sent by an I/O controller when it cannot perform 
a specified operation within the allotted period 



FDD 

Flexible disk drive 



Indirect 

An addressing mode 

Internal reject 

The reject generated by the CPU when the I/O 
controller fails to answer a request within the allotted 
time 

Initial entrance 

The initial entry point used when the program is first 
called 

Initialize disk 

The process of writing track and sector addresses on a 
disk pack 



I/O 



Input/output 



File mark 

Mark imposed on tape (as a separate record) to signify 
end-of-file 

Find next request 

MSOS routine that checks request queues and logical 
tables to find the next request to be executed. This 
routine assures that I/O channels remain busy so long as 
there are unstarted I/O requests. 

FNR 

Find next request 

Formatted data 

Data that is written in sector mode (for example, 
uniform records) 

fpi 

Frames per inch 

FREAD 

The formatted read request 

Function command 

Command to an I/O controller that prepares the 
peripheral device for an I/O transfer 

FWRITE 

The formatted write request 



Ghost interrupt 

An unsolicited interrupt from a peripheral device or an 
unused line 



Hang-up 

When a request is unable to be completed because a 
peripheral device is not able to issue the necessary 
interrupt, the condition is called an I/O hang-up 

Head 

The magnetic read or write head for a magnetic disk, or 
tape 

Hollerith 
A code 



Job processor 

The batch processing subsystem that initiates, 
monitors, and terminates all jobs executed in 
unprotected core 



Kernel drivers 

Drivers that are written in a special modularized 
fashion so that some modules may be excluded from the 
driver at system initialization, thereby saving main 
memory space during execution 



LCTT 

Low cost tape transport 

LOGl, LOGIA, LOG2 
Logical unit tables 

Logical unit tables 

Three tables that are used to locate alternate devices 
and other logical unit information 



lu 



Logical unit 



Macro instruction 

An instruction in a source language that is equivalent to 
a specified sequence of machine instructions; usually a 
mnemonic instruction that a programmer can write in a 
source program to call for library or special routines 

Macro interrupt 

An interrupt signaling an error or completion of an I/O 
operation, such as, a word transfer on the A/Q channel 
or a data block transfer on buffered channel ADT 

Main memory 

The principal memory of the CPU; it may be core or 
solid state (depending on the CPU) and includes all 
addressable memory within the CPU (excluding micro 
memory) 

MAKQ 

The request queuing program 



96769390 F 



A-3 



Mass memory 

The external magnetic memory, usually disk, but it may 
also be drum. In cases wliere neither disl< nor drum are 
included, it can be a magnetic tape device. 

Micro interrupt 

An interrupt that signals an error or completion of a 
single I/O operation, such as a single word transfer of 
an ADT block transfer. Micro interrupts are often 
handled by the driver without notification to the 
requesting module. 

M05 

NCR operating mode (set/sample instructions) 

MONI 

An entry point for the monitor 

Monitor 

The supervisory routine in an operating system that 
coordinates and controls the operation of user and 
system programs 

MOTION 

The motion request 

MSA 

Mass storage address 

MSOS 

Mass Storage Operating System 



Offset 

For the storage module drive, the ability to position the 
head slightly off the track in a direction perpendicular 
to the track. This may allow data recovery if the read 
head is not aligned perfectly with the track. 

Overflow 

For buffered transfers - the condition that occurs 
where an I/O device attempts to transfer more words of 
data than are provided for in the buffer 



pi, p2, p3 

The motion request fields. These appear in the motion 
word of the request and are processed in the order 
given, that is, pi before p2; p2 before p3. No more 
than three requests can be made in the same request. 

Page eject 

A line printer control command causing the printer to 
skip the remainder of the current page and to move to 
the top of the next page 

Parameter 

1. A variable that is given a constant value for a 
specific purpose or process 

2. A quantity in a routine that specifies a machine 
configuration, subroutines to be called, or other 
operating conditions 

Parameter list 

A part of a READ, WRITE, FREAD, i^WRITE, or 
MOTION request. The parameter list holds all the 
unique parameters necessary to prepare the driver for 
executing this specific request. 



Parity check 

A mode of checking data by adding a binary bit so that 
the sum of all binary bits (in a byte) is always even or 
always odd. If parity is not satisfied, the user program 
is usually notified that data quality is degraded. 

Physical device tables 

The table (PHYSTB) that holds the most information 
needed by the driver to control an I/O transfer for the 
specified logical unit. One physical device may have 
several logical unit designations. Each logical unit 
must have its own physical device table. Some I/O 
transfer parameters are saved in the physical device 
table at request time; last device status is saved at the 
end of the transfer. 

PHYSTB 

Physical device table 

Protect mode 

Areas of main memory or mass storage may be 
protected from write operations (or even read access) 
so that important programs and data cannot be 
inadvertently destroyed 

Pseudo disk 

A method of partitioning disk for addressing purposes so 
that a bit-limited addressing field (16 bits) may be used 
to address (in word mode) all of disk. The disk driver 
translates pseudo addresses to true disk addresses. 

Pseudo tape 

A method of treating data so that no matter where it is 
stored, it appears to have the same format to the user 
as if it had been stored on magnetic tape 



Q register 

One of the CPU arithmetic registers. It is also used for 
I/O transfers in conjunction with the A register. 

Queue 

A list of requests waiting to be processed; requests are 
ordered by priority level 



READ 

The normal input request (nonformatted) 

Real time 

Pertaining to a program for which time requirements 
are particularly stringent 

Relative 

A mode of addressing 

Request 

The method used by a program to start an I/O transfer. 
Standard requests are READ, WRITE, FREAD, FWRITE, 
and MOTION 

Request priority 

The priority assigned to a request. This determines the 
order in which a group of waiting requests are 
processed. Completion priority may differ from the 
request priority. 

Rewind 

To return a tape or disk file to its beginning 
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Scheduler 

The portion of the monitor that schedules programs to 
be executed (may be an initial, continuator, or error 
entry to the program). Other entry points are normally 
reached by a jump or return jump to a program entry 
point without using the scheduling function of the 
monitor. 

SCMM 

Small Computer Maintenance Monitor 

Sector 

A number of contiguous words in main or mass 
memory. Disks and drums have a preset sector size. 
When used in sector mode, sectors are consecutively 
numbered throughout the mass storage device. 
Initialization writes the sector addresses on the disk or 
drum. 

Seek 

The operation that positions the disk read/write heads 
over the track where the I/O transfer is to be made. 
All heads over all surfaces move as a unit; hence a seek 
operation positions heads over all tracks in a single 
cylinder. 

Segment 

A portion of the main memory lying in the same 65K 
set of memory address; for example, a 262K main 
memory would have four segments: through 65K, 65K 
through 131K, 131K through 196K, and 196K through 
262K. 

Slew 

To pass data until the desired end of input pattern is 
sensed 

SMD 

Storage module drive 

Status 

A state or condition of hardware or a task, for example, 
busy or not busy. I/O devices normally send status of 
the operation just finished to the CPU. 

Strobing 

Timing of data, as from a disk. By advancing or 
delaying the strobing of a data bit, the disk controller 
may be able to achieve a better data transition state. 
Variable strobing is one of the storage module drive 
modes of error correction. 

System data region 

A region in low memory reserved for data used by 
several programs. Physical device tables are located in 
the system data region. 

SYSDAT 

System data region 



Tape 

A data storage medium. Magnetic tape seven-, or 
nine-track) and punched paper tape are used by various 
CYBER 18/1700 systems. 

Thread 

A list of entries each of which contains a pointer to the 
next entry; for example, logical unit thread. I/O 
requests (for exanple, parameter lists) that are a part 
of the requesting program are usually threaded in place, 
and are therefore scattered throughout memory. An 



entry may be threaded to the beginning (highest 
priority), end (lowest priority), or someplace within the 
thread. In the last named case, the thread is broken 
and the new entry is threaded to both ends of the break 
in the thread. 

Timeout 

The expiration of a preset period of time. I/O transfers 
are normally allowed a predefined period. If one 
operation is not completed during this period, a timeout 
is declared and the driver enters error processing. 

Time-sharing 

The capability of a computing system to accommodate 
more than one user during the same interval of time 
without apparent restriction caused by the existence of 
other users; a given device is used in rapid succession 
by a number of other devices, or various units of a 
system are used by different users or programs. The 
sharing is automatically controlled and may or may not 
include a priority sciieme by using multiprocessing. 
Time-sharing may reduce total processing time from 
that required to do batch processing. 

Timer requests 

The stack of requests awaiting timeout checks. The 
timing program periodically checks requests. If the 
request is still in the stack at the end of the period, a 
timeout is declared for that operation. Completed 
operations are removed from the timer stack before 
timeout. 

Track 

A data storage region on disk, drum, or tape. Tape 
tracks are linear and do not require addresses; disk and 
drum tracks are circular and must be addressed to 
establish a start of track mark. 



Unload 

To remove a tape from ready status by rewinding it 
beyond the load point; the tape is then no longer under 
control of the computer. 

User program 

An object program loaded and entered under system 
control, includes batch and priority programs and 
library routines. 



v-field 

An error field in the parameter list used by the driver 
to notify the user program of I/O failures 



WES 

The address code in the Q register used to activate an 
I/O device. A director field is also included in the I/O 
device address. 

WRITE 

The normal output request (nonformatted) 

Write enable 

A command or physical device (for example, 
write-enable button on disk controller or write-enable 
ring on magnetic tape reel) allowing data to be written 
onto the device, or to a region of the device 

Wfrite protect 

A switch setting or program command that disables 
write operations into the protected region of mass 
storage or main memory 
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STANDARD EQUIPMENT/INTERRUPT B 

ASSIGNMENTS FOR CYBER 18 SERIES EQUIPMENT 



TABLE B-1. STANDARD EQUIPMENT/ INTERRUPT ASSIGNMENTS FOR CYBER 18-10, 18-20, AND 18-30 


Peripheral 


Equipment 
Code 


Macro 
Interrupt 


Micro 
Interrupt 


Teletypewriter/conversational display terminal 


1 


1 


1 


Paper tape reader 


2 


2 


2 


Paper tape punch 


2 


2 


2 


Card punch 


2 


2 


2 


Dual-channel communication line adapter 


2 


2 


2 


None 


3 


3 


3 


Line printer 


4 


4 


4 


None 


5 


5 


5 


None 


6 


6 


6 


Flexible disk drive (FDD) 


7 


7 


N/A 


Clock 


1 


8 


8 


Magnetic tape transport (NRZI only) 


9 


9 


9.0 


Eight-channel communications line adapter 


10 


10 


10 


Card reader 


11 


11 


11 


Magnetic tape transport (NRZI and phase encoded) 


12 


12 


N/A 


Not assigned 


13 


13 


N/A 


Storage module disk (SMD) 


14 


14 


N/A 


Cartridge disk drive (CDD) 


14 


14 


N/A 


Not assigned 


15 


15 


N/A 
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LOGICAL UNIT TABLES 



Three logical unit tables (LOGl, LOGIA, and L0G2) 
specify correspondences between logical and physical units, 
and between logical units and the threads of I/O tasks 
awaiting execution on those logical units. 



LOGl TABLE - ALTERNATE DEVICE TABLE 

The logical unit table indicates whether a logical unit has 
an alternate physical device, that can be used for the 
source I/O transfer. No more than one alternate unit can 
be used for a given logical unit. 



15 





15 


14 


13 


12 


11 


ia 


9 


LOGl 


LARGEST LEGAL LOGICAL UNIT NUMBER 


LI 














ALTERNATE LOGICAL 
UNIT NUMBER 


L2 
















L3 
















. 

















































Where; 
Bit 15 
Bit 14 

Bit 13 

Bits 12 - 10 
Bits 9 -0 



is reserved. 

is if the logical unit does not share 
the device. 

1 if the logical unit shares a device 
with another logical unit. 

is if the logical unit is operative. 
1 if the logical unit is out of 
service; the alternate, if any, is in 
use. 

are reserved for future use. 

are the alternate logical unit number. 



L0G1 A TABLE - LOGICAL/PHYSICAL UNIT TABLE 

This table contains pointers that relate each logical unit to 
its physical device table. 



LOGl A 
Li 

L2 
L3 



LARGEST LEGAL LOGICAL UNIT NUMBER 



ADDRESS OF PHYSTB SLOT CORRESPONDING TO 
THIS LOGICAL UNIT 



L0G2 TABLE - TASK THREADS 

This table contains pointers to the top of the request 
thread for each logical unit. The threads themselves are 
ordered by request priority. At threading time, the 
requests may be in unprotected memory. At execution 
time, a request being processed is moved to protected core 
unless swapping is prohibited. 



15 



L0G2 

LI 
L2 
L3 



LARGEST LEGAL LOGICAL UNIT NUMBER 



TOP OF THREAD FOR THIS LOGICAL UNIT NUMBER 



PHYSICAL DEVICE TABLES 



The physical device tables are included in SYSDAT (the 
system tables and parameters that are located at the 
beginning of main memory). 

Each physical device has a device table (PHYSTB) that 
contains the interfacing information specified by the user 
to the device. It contains the entry addresses to the driver 
responsible for operating the device, the station address 
that tells the driver which device to use, and the 
information that allows the driver to fulfill the current 
request. For all devices the table contains at least 16 
words. Words through 15 have a standard function for all 
devices. Additional words are added for special use by 
drivers. For kernel drivers, words 16 through 23 are also 
predefined. A detailed description of these common driver 
words is given in figure C-1. Figure C-2 details equipment 
type constants. 
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WORD 


15 14 11 


10 9 8 7 


4 3 


SYMBOLIC 
NAME 





1010 01 00000 


ELVL 


1 


DRIVER INITIATOR ADDRESS 


EDIN 


2 


DRIVER CONTINUATOR ADDRESS 


EDCN 


3 


DRIVER I/O HANG-UP DIAGNOSTIC ADDRESS 


EDPGM 


4 


DIAGNOSTIC CLOCK 


EDCLK 


5 


LOGICAL UNIT CURRENTLY ASSIGNED TO THIS DEVICE 


ELU 


6 


CURRENT REQUEST PARAMETER LIST LOCATION 


EPTR 


7 


CONVERTER 


EQUIP CODE 


STATION CODE 


EWES 


8 


REQUEST STATUS BITS 


EREQST 


9 


STATUS BITS 


ESTAT1 


10 


CURRENT LOCATION FOR DRIVER 


ECCOR 


11 


LAST LOCATION +1 FOR DRIVER 


ELSTWD 


12 


LAST EQUIPMENT STATUS READ 


ESTAT2 


13 


DRIVER LENGTH 


MASLGN 


14 


MASS STORAGE ADDRESS OF DRIVER 


MASSEC 


15 


USED FOR RE-ENTRANCY BY FNR, MAKQ, COMPRQ 


RETURN 


16 


KERNEL FAULT IF ERROR OCCURS 


FLTCOD 


17 


DIAGNOSTIC LOGICAL UNIT 


DIAGLU 


18 


COUNT OF GHOST INTERRUPTS 


GHOSTI 


19 


MICRO-INTERRUPT NUMBER 


MICROI 


20 


TIMEOUT PERIOD TO WAIT FOR AN INTERRUPT 


TIMOUT 


21 


STATUS AFTER INITIAL ENTRY 


SENTRY 


22 


STATUS AFTER INTERRUPT 


SINTER 


23 


STATUS AFTER INTERRUPT TIMEOUT 


STMEO 


24 


CONTROL POINT LOCATION 


CPVLOC 


• 


: . 





STANDARD 
FOR ALL 
DEVICES 



STANDARD 
FOR KERNEL 
DRIVERS 



STANDARD FOR DMA 
KERNEL DRIVERS, 
EXCEPT FOR SMD 

OPTIONAL FOR 
DRIVER AND/ 
OR KERNEL 



Figure C-1. Common \NoTds in PHYSTB for All Kernel Drivers 



C-2 



96769390 F 



The following is a detailed description of each of the words Word 8 

for all drivers (figure C-1). 



Word ELVL 

520x^5; a scheduler request to operate the 
(friver initiator address at level x, the driver 
priority level 

Wordl EDDM 

The driver initiator address 

Word 2 EDCN 

The driver continuator address; control is 
transferred to EDCN on interrupt at the 
priority level assigned to the interrupt trap 
region. This priority level must be the same 
as the priority level specified by word 0. 

Word 3 EDPGM 

The driver error routine address; control is 
transferred to EDPGM when the diagnostic 
clock is counted down to negative by the 
diagnostic timer at the driver priority level. 

Word 4 EDCLK 

The diagnostic clock; this location is set by 
the driver and counted down by the diagnostic 
timer for a hardware completion interrupt. It 
is set idle (-1) by a complete request. 

Word 5 ELU 

The logical unit currently assigned to the 
device; it is zero if the device is not in use. It 
is set by the request processor and may be 
reassigned by find-next-request and cleared by 
find-next-request or complete request. 

Word 6 EPTR 

Call parameter list location for current Word 9 

request; it is set by find-next- request. 

Word 7 EWES 

Hardware/address 

Bits Code 

through 6 

7 through 10 



Station 

Equipment (refer to 
appendix B) 



EREQST 




Request status 


Bits 


Code 




15 


1 


If operation is In progress 







If operation is complete 


14 


1 


If driver detects I/O hardware 
failure 


13 






12 
11 


The equipment class 







Class undefined 




1 
2 
3 


Magnetic tape 
Mass storage 
Card 




4 

5 


Paper tape 
Printer 




6 
7 


Teletypewriter 
Reserved for future use 


10 
thru 


Equipment type constant (T) 


4 






See figure C-2 


3 


Not 
Used 


(reserved) 



If device may be written by 
unprotected programs 

If device may be read from 
unprotected programs 

if device is not available to 
unprotected programs 



11 through 15 Converter 

This equipment status is obtained by loading 
this word into Q followed by input. Status is 
saved in word 12, ESTAT2. 



ESTATl 




Status word 1 




Bits 


Code 


Device 


15 


1 


If error condition 
and/or end-of-file 
is detected 


14 


1 


If fewer words are 
read than requested 


13 


1 


If device remains 
ready after detecting 
an error or end-of- 
file or both 



Driver 
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Bits Code 



Device 



12 

11 

10 

9 

8 

7 

6 



Reserved for special use 
by individual drivers 



If this is a control 

character 

If this is the first 

character Driver 

1 If ASCII; if binary 
mode 

1 If lower character; 

if upper character 

1 If format READ or 

WRITE; if 
unformatted FNR 

1 If WRITE; if READ 



Wbrd 16 FLTCOD 

Kernel fault code if an error occurs 

Ward 17 DIAGLU 

Diagnostic logical unit. If ELU equals DIAGLU, 
then the request is completed with error. The 
error is not logged in the engineering file and 
ALTDEV is not called. 

Word 18 GHOSTI 

A count of the number of ghost (unexpected) 
interrupts that have occurred 

Word 19 MICROI 

The device micro-interrupt number, if any 

Word 20 TIMOUT 

The amount of time in seconds to wait for an 
expected interrupt 



Word 10 ECCOR 



The location where the driver next stores or 
obtains data; it is set initially by FNR and 
updated by the driver (refer to 
Find-Next-Request in section 2). 



Word 11 ELSTWD 



Last location + 1 where the driver is to store or 
obtain data to satisfy the request 



Word 12 ESTAT2 



Status word 2; the last value of the equipment 
status (refer to word 7) 



Word 13 MASLGN 



The length of the driver for this device when 
the driver is mass-storage resident. This word 
is zero if the driver is corerresident. 



Word 14 MASSEC 



Contains the name associated with the sector 
number on mass storage; if the driver is 
core-resident, this name is patched with 
7FFFF16. 



Word 15 RETURN 



Used for a return address by NFNR, MAKQ, and 
NCMPRQ 



Word 21 SENTRY 

The status after the initial entry into the kernel 

Word 22 SINTER 

The status after the device has interrupted 
(entry into the l<ernel continuator entry) 

Word 23 STIMEO 

The status after the device interrupt has time 
out 

Vford24 CPVLOC 

Control point location. Used for DMA devices 
only (except SMD). 



Word 25 These words may be added to the device table 
if required for special purposes. For example, 
they can be used to count the lines per page of 
output, link several table together all using the 
same driver/kernel, or save multiple status 
words (the auxiliary status words should start at 
word 24). 



In the case of multiple devices (for example LCTTs), a 
physical device table is required for each unit. The 
PHYSTB is located in SYSDAT. 

Following the standard PHYSTB table, PHYSTBs for 
selected specific devices are shown in figures C-3 through 
C-10. 



C-4 



96769390 F 



CODE 



DEVICE 



CODE 



DEVICE 






1711 


48 


1 


1721/1722 


49 


2 


1723/1724 


50 


3 


1752 


51 


4 . 


713-10/711-100 713-120 


52 


5 


1738/853 


53 


6 


1751 


54 


7 


1739-1 


55 


8 


1738/854 


56 


9 


1731/601 


57 


10 


SOFTWARE BUFFER 


58 


11 


COSY DRIVER 


59 


12 


1728/430 


60 


13 


CORE ALLOCATOR 


61 


14 


1733-1/854 


62 


15 


1733-2/856-2 


63 


16 


1733-2/856-4 


64 


17 


1742-30 


65 


18 


1742-120 


66 


19 


1740/501 


67 


20 


1732-2/615-73 


68 


21 


1732-2/615-93 


69 


22 


1732-1/1706/608 


70 


23 


1726/405 


71 


24 


1732-1/608 


72 


25 


1732-1/609 


73 


26 


1713 KEYBOARD 


74 


27 


1713 PUNCH 


75 


28 


1713 READER 


76 


29 


1729-2 


77 


30 


1732-1/1706/609 


78 


31 


SOFTWARE DUMMY 


79 


32 


364-4/361-1 


80 


33 


364-4/361-4 


81 


34 


1742-1 


82 


35 


1777 READER (PAPER TAPE STATION) 


83 


36 


PSEUDO TAPE 


84-90 


37 


1777 PUNCH (PAPER TAPE STATION) 


91 


38 


1729-3 


92 


39 


1733-1/853 


93 


40 


1731/1706/601 


94 


41 


1726/1706/405 


95 


42 


1747 


96 


43 


1744/274 


97 


44 


1536 LOCAL 


98 


45 


1501 REMOTE 


99 


46 


1536 REMOTE 


100-127 


47 


1544 REMOTE 





1553 REMOTE 

1555 REMOTE 

1566 REMOTE 

1547 REMOTE 

1595 SERIAL I/O CARD 

1732-3/616/72 

1732-3/616-92/95 

1743-2 

1745/210 

1725-1 CARD PUNCH 

1720-1 READER 

1720-1 PUNCH 

MAGNETIC TAPE SIMULATOR 

1732-2 LONG RECORD DRIVER 

1810-1/1811-1 CDT/PRINTER 

1728-30/60 CARD READER 

1827-30 LINE PRINTER 

1860-72 7-TRACK TAPE 

1860-92/95 9-TRACK TAPE 

1832-5 CASSETTE 

1833-5 FLEXIBLE DISK 

1833-1/1867-10 DISK 

1833-1/1867-20 DISK 

EXTENDED CORE DRIVER 

PSEUDO DISK 

1843-2 8-CHANNELCLA 

1866-14 CARTRIDGE DISK 

1866-12 CARTRIDGE DISK 

1827-7 MATRIX PRINTER 

TAB 501 CARD PUNCH 

SPOOLED PRINTER 

1843-1 2-CHANNELCLA 

1860-5 MAGNETIC TAPE 

1843-3 SYNCHRONOUS CLA 

1843-5 BUFFERED CLA 

1867-40 180MBSMD 

UNASSIGNED 

915 OCR PAGE READER 

929 DOCUMENT READER 

936 DOCUMENT READER 

UNASSIGNED 

955 PAGE/DOCUMENT READER 

UNASSIGNED 

979 READER SORTER 

UNASSIGNED 

UNASSIGNED 

FOR USER ASSIGNMENT 



Figure C-2. Equipment Type Constants (Bits 10-4 of word 8) 
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WORD 


23 
24 
25 
26 
27 
28 
29 
30 
30 

31 

32 

33 

34 
35 
36 
37 
38 
39 



DESCRIPTION 



SYMBOLIC 
NAME 



WORDS THROUGH 23 HAVE THE STANDARD KERNEL DRIVER 
MEANINGS. NOTE HOWEVER THAT WORDS 21 THROUGH 23 ARE 
CALLED BY THE SPECIAL NAMES OF: 

SENTRY - WORD 21, INITIATOR DIRECTOR STATUS 1 
SINTER - WORD 22, CONTINUATOR DIRECTOR STATUS 1 
STIMEO -TIMEOUT DIRECTOR STATUS 1 



INITIATOR DIRECTOR STATUS 2 



CONTINUATOR DIRECTOR STATUS 2 



TIME OUT DIRECTOR STATUS 2 



CARD COLUMN COUNTER 



3,3 MS COUNTER AT FEED TIME 



3.3 MS COUNTER AT COLUMN 1 



3.3 MS COUNTER AT EOP (DIAGNOSTIC LOGICAL UNIT) 



16-BIT PACKED RAW DATA (NONDIAGNOSTIC LOGICAL UNIT) 



CURRENT ADDRESS FOR RAW DATA (SAME AS WORD 10, ECCOR, IF 
DIAGNOSTIC LU) 



LAST WORD ADDRESS PLUS ONE OF RAW DATA BUFFER (SAME AS 
WORD 1, ELSTWD, IF DIAGNOSTIC LU) 



DESELECTS INTERRUPT CONDITION WORDS IN COMBINATION WITH 
ALL POSSIBLE INTERRUPT STATES: 

4 - DESELECTS INTERRUPT ON DATA 

8 - DESELECTS INTERRUPT ON EOP 

$10 - DESELECTS INTERRUPT ON ALARM 



ADDRESS OF ALTERNATE WAIT ROUTINE IF VALUE NONZERO 



NONZERO VALUE INDICATES TIMEOUT OCCURRED 



CONVERTED WORD LENGTH FOR BINARY READS 



EXPECTED SEQUENCE NUMBER FOR FORMATTED BINARY CARDS 



EXPECTED SEQUENCE NUMBER (SEQ SAVED VALUE) 



ACCUMULATIVE CHECKSUM VALUE 



RAWSI2 

RAWSC2 

RAWSE2 

COLNUM 

TFEED 

TCOL01 

TCOLEP 

WORD 

FWA 

LWA 

INTBIT 

WAITAD 

TIMFLG 

LENGTH 

SEQ 

OLDSEQ 

CHKSUM 



STANDARD 
FOR ALL 
KERNEL 
DRIVERS 



Figure C-3. CB 104 Card Reader PHYSTB (Sheet 1 of 2) 
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WORD 
40 

41 

41 

42 
43 
44 
45 
46 
47 
48 
49 

128 



DESCRIPTION 



LOOP COUNTER USED TO COUNT NUMBER OF PASSES REQUIRED TO 
CONVERT RAW DATA 



MOTION OPTIONS TEMPORARY LOCATION 



FLAG TO DETERMINE AT WHAT POINT RAW DATA IS BEING CONVERTED 
FOR FORMATTED BINARY. 
-0 = PROCESSING COLUMN 1 OR 2 OF FIRST CARD 

= PROCESSING COLUMN 1 FOR SUBSEQUENT CARDS READ 

0/^ ALL OTHER CASES 



END OF FILE INDICATOR 



026/029 MODE FLAG 



ADT TABLE CONTROL WORD 



ADT TABLE FWA - 1 



ADT TABLE LWA 



ADT TABLE DUMMY 



SIM200 LOGICAL UNIT 



4? 80 WORD RAW DATA BUFFER 



SYMBOLIC 
NAME 



CYCLE 
MOTREQ 

NEWCRD 

EOF 

RMODE 

ADTCW 

ADTFW 

ADTLW 

ADTXX 

SIM200 



jL BUFR 



NOTE: INITIAL VALUE OF WORDS 24-41 AND 43-122 IS 0. INITIAL VALUE OF WORD 42 IS F 



16- 



Figure C-3. CB 104 Card Reader PHYSTB (Sheet 2 of 2) 
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WORD 



0-24 



24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 



DESCRIPTION 



CONTROL POINT LOCATION 



LAST DATA TRANSFER FUNCTION 



BUFFER SIZE FOR SPLIT TRANSFERS 



CYLINDER ADDRESS 



MASK FOR SEEK COMPLETE 



ADDRESS FOR 96 WORD 



TEMPORARY FIRST WORD - FOR WORD ADDRESSING 



TEMPORARY LAST WORD - FOR WORD ADDRESSING 



NUMBER OF WORDS- FOR WORD ADDRESSING 



REQUEST CODE 



REQUEST PRIORITY 



START SECTOR FOR COMPARE OR RETRY 



FIRST WORD ADDRESS FOR COMPARE OR RETRY 



ERROR COUNTER - FOR RECOVERY 



DATA TRANSFER FUNCTION CODE 



NUMBER OF SECTOR CURRENTLY IN BUFFER 



LAST VALUE OF TRUE SECTOR ADDRESS 



LAST VALUE OF TRUE CYLINDER ADDRESS 



LAST VALUE OF CWA 



LAST VALUE OF CURRENT BANK STATUS 



RETURN INDEX AFTER DATA TRANSFER 



SOFTWARE SECTOR NUMBER 



UNIT-SELECT PARAMETER 



TEMPORARY SECTOR BUFFER - FOR WORD ADDRESSING 



COMPARE OR CHECKWORD - CHECK MOTIONS PARAMETER 



RESERVED FOR OVERLAY ROUTINE 



RESERVED FOR OVERLAY ROUTINE 



RESERVED FOR OVERLAY ROUTINE 



SYMBOLIC 
NAME 



CPVLOC 

FUNCT 

BUFSIZ 

CYLADR 

SEKBIT 

ABUFF 

TEMFWD 

TEMLWD 

WORDNO 

TEMREQ 

PRILVL 

SVFLAD 

SAVFWD 

ERCONT 

FDATAF 

BUFSEC 

STAT12 

STATU 

STAT2 

STAT3 

EXTRA 

FILEAD 

FCONN 

TEMSEC 

COMCHC 

ECALL1 

ECALL2 

ECALL3 



T 



STANDARD 
FOR ALL 
KERNEL 
DRIVERS 

__± 



Figure C-4. Cartridge Disk Driver PHYSTB (Sheet 1 of 2) 
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WORD 

52 

53 

54 

55 

56 

57 

58 
59 

60 

61 

62 

63 



DESCRIPTION 



RESERVED FOR OVERLAY ROUTINE 



RESERVED FOR MOTIONS 



NUMBER OF SECTOR ON DISK (BETWEEN 0-28) 



SELECTED BANK 



ALARM - STATUS 



RTZS INDICATOR AFTER DEVICE SEEK ERROR 



LAST Q REGISTER 



LAST A REGISTER 



HARDWARE DYNAMIC STATUS 



FIRST SECTOR ADDRESS ON DISK 1 



LINK TO THE NEXT PHYSTB 



96 WORD BUFFER 



SYMBOLIC 
NAME 



ECALL4 

TMOPAR 

SECTAD 

BANK 

ALRMST 

RTZS 

LASTQ 
LASTA 

DYNMIC 

DISK1 

OTHER 

BUFF 



Figure C-4. Cartridge Disk Driver PHYSTB (Sheet 2 of 2) 
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WORD 




DESCRIPTION 



23 

24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 



CYLINDER ADDRESS FOR TRANSFER 



TRACK AND SECTOR FORMATTED 



UPPER FIELD OF ADDRESS (BITS 17-16 OF DMA) 



TEMPORARY CYLINDER FOR WORD ADDRESSING 



USED BY WORD ADDRESSING (TRACK/SECTOR) 



USED BY WORD ADDRESSING (FWA) 



USED BY WORD ADDRESSING (LWA) 



USED BY WORD ADDRESSING (WORD IN SECTOR) 



LAST VALUE OF CONTROL UNIT STATUS 



LAST VALUE OF DRIVE 1 STATUS 



LAST VALUE OF DRIVE 2 STATUS 



DATA TRANSFER FUNCTION CODE 



LAST DATA TRANSFER FUNCTION CODE 



RETURN ADDRESS INDEX FOR DATA TRANSFER 



DA NUMBER 



LOGICAL DRIVE NUMBER OF DISK 



COUNTER FOR SEEK ERROR 



RETURN SEEK TO ZERO FLAG 



ERROR COUNTER 



REQUEST PRIORITY 



REQUEST CODE 



RESERVED FOR OVERLAY 



RESERVED FOR OVERLAY 



T 



STANDARD 
FOR ALL 
KERNEL 
DRIVERS 



Figure C-5. Storage Module Driver PHYSTB (Sheet 1 of 2) 
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WORD 



DESCRIPTION 



47 
48 
49 
50 
51 
52 



RESERVED FOR OVERLAY 



RESERVED FOR OVERLAY 



NOT USED 



INDEX THROUGH OFFSET JUMP TABLE 



LAST VALUE OF OFFSET VALUE 



SPECIAL WORD FOR SPECIFYING SYSTEM CONFIGURATION AND FOR 
DIAGNOSTIC PROGRAM 
BIT 15= 1 DA 
= 12DA 
BIT 14= 1 DRIVE 

= 1 MULTIPLE DRIVES 
BIT 13= ONON-TIMESHARE SYSTEM 
= 1TIMESHARE SYSTEM 
3-0 = SET BY DIAGNOSTIC PROGRAM 
= NORMAL TRANSFER 
= 6FWRITE 
= OTHER ADDRESS TAGS 



53 ECC ERROR RECOVERY FLAG (1 = DO RECOVERY) 

54 I MAXIMUM ERROR RETRIES FOR SEEK OPERATION 

55 MAXIMUM ERROR RETRIES FOR DATA TRANSFER 

56 MAXIMUM ERROR RETRIES FOR CONTROL UNIT CONNECTION 

57 MAXIMUM TIME COUNTS LOOP NUMBER FOR CONTROL UNIT 

58 DIAGNOSTIC TIMER VALUE FOR DATA TRANSFER 

59 DIAGNOSTIC TIMER VALUE FOR CU WAIT 

60 DIAGNOSTIC TIMER VALUE FOR ALT CHANNEL WAIT 

61 DIAGNOSTIC TIMER VALUE FOR SEEK OPERATION 

62 FORCE RELEASE COUNT 

63 TIMESHARE CONTROL POINT (CP) VALUE 

64 THESE BITS ARE SET BY DIAGNOSTIC PROGRAM 
BIT 15- EARLY STROKE 

14- LATE STROKE 
2- SEEK ONLY REQUEST 
1- DO RETRIES ON ALARM ERROR 
0- DO RECOVERY ON ALARM ERROR 

65 ADDRESS OF 96 WORDS BUFFER 

66 LINK FOR MULTIPLE PHYSICAL DEVICE TABLE 

67 RETURN FROM CONNECT CU SUBROUTINE 

68 SELECT STATUS VALUE (15-8) AND MASK (7-0) SOMB SMD 

69 DRIVE SIZE VALUE (15-8) AND MASK (7-0) SOMB SMD 

70 MAXIMUM WORDS/SECTOR 

71 MAXIMUM SECTORS/TRACK 



Figure C-5. Storage Module Driver PHYSTB (Sheet 2 of 2) 
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WORD 




23 

24 

25 

26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 

39 
40 
41 



DESCRIPTION 



CURRENT TRACK/SECTOR 

BITS 15-8 - TRACK NUMBER 0-76 

BITS 7-0 -SECTOR NUMBER 1 -SECTRK 



DEFINE BAD TRACKS OF DISKETTE: 
BITS 15-8 - FIRST BAD TRACK NUMBER 
BITS 7-0- SECOND BAD TRACK NUMBER 



ERROR COUNT OF MEDIA ERRORS WITHIN REQUEST 



NUMBER OF ERROR RECOVERIES FROM MEDIA ERRS 



NUMBER OF SECTORS PER TRACK 



NUMBER OF WORDS PER SECTOR 



SEEK ERROR COUNTER 



I/O ERROR FLAG 



SECTOR ADDRESS OF LAST READ/WRITE OPERATION 



LU NUMBER OF LAST DEVICE TO DO READ/WRITE OPERATION 



LU NUMBER OF ASSOCIATED MAG TAPE SIMULATOR 



UNUSED 



STARTING ADDRESS OF FILE REGISTER 



PROGRAM PATH THROUGH A/Q READ/WRITE 



LAST LOGICAL SECTOR FOR REQUEST. CALCULATES MSA LAST. 



WORD ADDRESSABLE SECTOR OFFSET, 1ST SECTOR 



SECTOR OFFSET FOR END OF DATA IN REQUEST 



FLEXIBLE DISK DRIVE PHYSICAL DEVICE TABLE THREAD 



SYMBOLIC 
NAME 



TRKSEC 

BADTKS 

ERRCNT 

ERRCOV 

SECTRK 

WRDSEC 

SKERCT 

lOERFG 

LSTSEC 

LSTLU 

MTGPLU 

SFA 
AQPATH 

LGLSEC 

WRDFWA 
WRDLWA 

FDDPTH 



T 



STANDARD 
FOR ALL 
KERNEL 
DRIVERS 



i 



MSA IN 

TRACK/ 

SECTOR 

t_ 



T 



CDC OR IBM 
FORMAT 

i 



Figure C-6. ITOS 2 Flexible Disk Drive FHYSTB 
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WORD 


23 

24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 

37 

38 
39 

40 



DESCRIPTION 



FORTRAN LOGICAL UNIT NUMBER 



PAPER MOTION COMMAND WORD 



COUNT FOR SPACE FILL 



CHARACTER OUTPUT COUNT 



NUMBER OF CHARACTERS PER LINE 



LINE COUNT 



MAXIMUM NUMBER OF LINES PER PAGE 



MOTION REQUEST WORD SAVED HERE 



ZERO IF ALL BLANKS IN LINE 



FIRST CHARACTER FLAG 



CHARACTER INDEX TO USER BUFFER 



NUMBER OF CHARACTERS IN USER BUFFER 



64/96 CHARACTERS SET AND DOUBLE BUFFERING FLAG 
BIT 0= 1 FOR DOUBLE BUFFERING 
BIT 15 = 1 FOR 96-CHARACTER SET 
BIT 15 = FOR 64-CHARACTER SET 



REQUEST COMPLETE FLAG 



NEW BUFFER ADDRESS 



SAVED FAULT CODE 



SAVED ESTAT1 



SYMBOLIC 

NAME 



FINLU 

MOTCMD 

BLNKCT 

CHARCT 

LINLEN 

LINCTO 

MAXLIN 

MTNREQ 

BLNKDT 

FRSTCH 

CHINDX 

INCHAR 

DBLBUF 

REQCFL 

NEWBUF 
SVFLTC 

SVEST1 



STANDARD 
FOR ALL 
KERNEL 
DRIVERS 



i 



Figure C-7. 1827 Line Printer PHYSTB 
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WORD 


23 
24 

25 

26 

27 

28 

29 

30 

31 

32 

33 

34 

35 

36 

37 

38 

39 

40 

41 

42 

43 



DESCRIPTION 



FORTRAN LOGICAL UNIT NUMBER 



CLA LOGICAL PORT NUMBER FOR THIS DEVICE 



START ADDRESS FOR CONVERTED BUFFER 



LAST LOCATION + 1 OF CONVERTED BUFFER 



NEXT CHARACTER FOR OUTPUT BUFFER 



NEW REQUEST CODE, PRIORITIES 



NEW COMPLETION ADDRESS 



NEW THREAD 



NEW V-FIELD, LOGICAL UNIT 



NEW NUMBER OF CHARACTERS 



NEW START DATA BUFFER 



NEW CONTROL POINT INDICATOR 



NEW START ADDRESS REQUEST BUFFER/HEADER 



NUMBER OF BLANKS TO OUTPUT FOR TAB 



N, SUCH THAT TAB STOPS EVERY N CHARACTERS 



CURRENT PAGE LINE COUNTER 



MAXIMUM LINES PER PAGE 



LINES TO ADD TO LINE COUNT FOR VERT TAB 



PHYSTB THREAD 



PSEUDO COMPLETION FOR NEW REQUEST 



SYMBOLIC 
NAME 



* 
STANDARD 
FOR ALL 
LERNEL 
DRIVERS 



FTNLU 

PORT 

BEGBUF 

ENDBUF 

NEXCAR 

NEWREQ 

NEWCOM 

NEWTHD 

NEWVLU 

NEWNCH 

NEWSDB 

NEWCPI 

NEWSHD 

TABCNT 

TABSET 

LINCT 

MAXLIN 

VTABLF 

ELINK 

NCOMP 



Figure C-8. 1827-7/1843-2 Matrix Printer PHYSTB Pesudo Driver 
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WORD 



DESCRIPTION 



24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 



UNIT AND MODE SELECT 



TEMPORARY STORAGE 



HALF-WORD FLAG 



ADT TABLE CONTROL WORD 



ADTTABLEFWA-1 



ADTTABLELWA 



REQUEST TYPE FLAG 



RECOVERY RETURN ADDRESS 



RECOVERY CHECKSUM 



RECOVERY COUNT FLAG 



RECOVERY FLAG BIT= 1 (NO RECOVERY) 



REQUEST CODE 



WORD 4 OF REQUEST 



MAXIMUM PHYSICAL RECORD SIZE 



PACK/UNPACK BUFFER ADDRESS 



PHYSICAL DEVICE TABLE THREAD 



SYMBOLIC 
NAME 



STANDARD 
FOR ALL 
KERNEL 
DRIVERS 



UNTMOD 

ETEMP1 

HAFURD 

ADTCW 

ADTFW 

ADTLW 

MFLG 

RRETAD 

RCKSUM 

RCNTFG 

RFLAG 

QSTCOD 

QSTWD4 

PHSREC 

ABUFF 

ELINK 



1 



Figure C-9. LCTT PHYSTB 
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WORD 


23 

24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 



DESCRIPTION 



CONTROL POINT LOCATION 



RETURN FOR RECOVERY 



A REGISTER AT LAST OUTPUT 



Q REGISTER AT LAST OUTPUT 



UNIT AND MODE SELECT CODE 



WORD 4 OF REQUEST 



RECOVERY COUNT FLAG 



RECOVERY FLAG BIT 15 = 1 DISABLE 



MAXIMUM PHYSICAL RECORD SIZE (7 TRACK) 



PACK/UNPACK BUFFER ADDRESS (7 TRACK) 



ALARM STATUS WORD 



TRANSPORT STATUS 



PHYSTAB THREAD 



SYMBOLIC 
NAME 



CPVLOC 

RTRECV 

OUTARG 

OUTQRG 

UNTMOD 

QSTWD4 

RCNTFG 

RFLAG 

PHYREC 

ABUFF 

ALRMST 

TRNSPT 

ELINK 



STANDARD 
FOR ALL 
KERNEL 
DRIVERS 



i. 



Figure C-10. LCTT/Formatter (1860-5/6) PHYSTB 
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The 1963 American Standard Code for Information contain the high-order three bits of the code for the 

Interchange (ASCII) is used by MSOS. ASCII code uses character in that column. The code is given in ascending 

eight bits: bit 8, which is always zero, is omitted in sequence. Table D-1 lists ASCII conversion symbols, 

table D-1. Bits 1 through 4 contain the low-order four bits Table D-2 lists ASCII and BCD character sets, 
of code for the character in that row. Bits 5 through 7 
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TABLE D-1. CODE CONVERSION TABLE 



ASCII 
Sjmibol 


Bit 
Configuration 


Hexadecimal 
Number 


Meaning 


NULL 


000 0000 





Null/idle 


SOM 


000 0001 


1 


Start of message 


EOA 


000 0010 


2 


End of address 


EOM 


000 0011 


3 


End of message 


EOT 


000 0100 


4 


End of transmission 


WRU 


000 0101 


5 


Who are you 


RU 


000 Olio 


6 


Are you 


BELL 


000 0111 


7 


Audible signal 


feq 


000 1000 


8 


Format effector 


HT/SK 


000 1001 


9 


Horizontal tab skip (punched card) 


LF 


000 1010 


A 


Line feed 


Vtab 


000 1011 


B 


Vertical tabulation 


FF 


000 1100 


C 


Form feed 


CR 


000 1101 


D 


Carriage return 


SO 


000 1110 


E 


Shift out 


SI 


000 nil 


F 


Shift in 


DCq 


001 0000 


10 


Device control/data link escape 


DCi 


001 0001 


11 






DCg 
DC3 


001 0010 
001 0011 


12 
13 


h 


Device controls 


DC4 (STOP) 


001 0100 


14 




Device control/stop 


ERR 


001 0101 


15 


Error 


SYNC 


001 Olio 


16 


Synchronous idle 


LEM 


001 0111 


17 


Logical end of media 


So 


001 1000 


18 •] 






h 


001 1001 


19 






S2 


001 1010 


lA 






S3 


001 1011 


-IB 


1 


Information separators 


S4 


001 1100 


IC 






S5 


001 1101 


ID 






S6 


001 1110 


IE 






S7 


001 nil 


IF . 







D-2 
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TABLE D-2. ASCII AND BCD CHARACTER SET 



8-Bit 
ASCII 
Code si 
(Hex) 



20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
2A 
28 
2C 
2D 
2E 
2F 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
3A 
38 
3C 
3D 
3E 
3F 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 



Character 



Space 
I 



026lt 
Punches 



No punch 

11-8-2 

8-7 

12-8-7 

11-8-3 

0-8-5 

8-2 

8-4 

0-8-4 

12-8-4 

11-8-4 

12 

0-8-3 

11 

12-8-3 

0-1 



1 

2 

3 

4 

5 

6 

7 

8 

9 

8-5 

11-8-6 

12-8-6 

8-3 

8-6 

12-8-2 

0-8-7 

12-1 

12-2 

12-3 

12-4 

12-5 

12-6 

12-7 

12-8 

12-9 



029Tf 
Punches 



No punch 

12-8-7 

8-7 

8-3 

11-8-3 

0-8-4 

12 

8-5 

12-8-5 

11-8-5 

11-8-4 

12-8-6 

0-8-3 

11 

12-8-3 

0-1 



1 

2 

3 

4 

5 

6 

7 

8 

9 

8-2 

11-8-6 

12-8-4 

8-6 

0-8-6 

0-8-7 

8-4 

12-1 

12-2 

12-3 

12-4 

12-5 

12-6 

12-7 

12-8 

12-9 



6-Bit 
Ext. BCD 
Magnetic 
Tape 
(Octal) 



20 
52 
17 

n 

53 
35 
00 (35) 
14 
34 
74 
54 
60 
33 
40 
73 
21 
12 
01 
02 
03 
04 
05 
06 
07 
10 
11 
15 
56 
76 
13 
16 
72 
37 
61 
62 
63 
64 
65 
66 
67 
70 
71 



■fit 



tThe CDC standard 1.10.003 is supported by an assembly option. For CDC ASCII mode of operation, 
the card punches 12-8-2 and 12-0 are stored internally as 7B. The card punches 11-8-2 and 11-0 
are stored internally as 7D. For line printer operations, the internal codes 78 and 7D are 
converted to 5B and 5D to allow printing the hardware compatible graphic characters [ (left 
bracket) and ] (right bracket). 

''"''to operate in 026 punched card mode, ASCII 64 options are selected. To operate in 029 punched 
card mode, ASCII 68 options are selected. These options are assembly-time options for each 
driver affected. 

^Since 173X magnetic tape controllers do not provide any code conversion, BCD code 00 is illegal 
■ and causes a noise record, or BCD code 35 is substituted for the illegal 00 code to prevent 
tape errors. On tape write operations the ASCII codes $25 (%) and $26 ( & ) are written as BCD 
35 (octal). On tape read operations, the BCD code 35 (octal) is always translated to an ASCII 
$25 («). 
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TABLE D-2. 


ASCII AND BCD CHARACTER SET (Contd) 












6-Bit 


8-Bit 








Ext. BCD 


ASCII 








Magnetic 


Codes 




026 


029 


Tape 


(Hex) 


Character 


Punches 


Punches 


(Octal) 


4A 


J 


11-1 


11-1 


41 


4B 


K 


11-2 


11-2 


42 


4C 


L 


11-3 


11-3 


43 


4D 


M 


11-4 


11-4 


44 


4E 


N 


11-5 


11-5 


45 


4F 





11-6 


11-6 


46 


50 


P 


11-7 


11-7 


47 


51 


Q 


11-8 


11-8 


50 


52 


R 


11-9 


11-9 


51 


53 


S 


0-2 


0-2 


22 


54 


T 


0-3 


0-3 


23 


55 


U 


0-4 


0-4 


24 


56 


V 


0-5 


0-5 


25 


57 


w 


0-6 


0-6 


26 


58 


X 


0-7 


0-7 


27 


59 


Y 


0-8 


0-8 


30 


5A 


Z 


0-9 


0-9 


31 


5B 


[ 
\ 


12-8-5 


12-8-2 


75 


5C 


0-8-2 


0-8-2 


36 


5D 


] 


11-8-5 


11-8-2 


55 


5E 


11-8-7 


11-8-7 


57 


5F 


A 


0-8-6 


0-8-5 


32 


60 


@ 




8-1 




61 


a 




12-0-1 




62 


b 




12-0-2 




63 


c 




12-0-3 




64 


d 




12-0-4 




65 


e 




12-0-5 




66 


f 




12-0-6 




67 


g 




12-0-7 




68 


h 




12-0-8 




69 


i 




12-0-9 




6A 


j 




12-11-1 




6B 


k 




12-11-2 




6C 


1 




12-11-3 




6D 


m 




12-11-4 




6E 


n 




12-11-5 




6F 







12-11-6 




70 


p 




12-11-5 




71 


q 




12-11-8 




72 


r 




12-11-9 




73 


s 




11-0-2 




74 


t 




11-0-3 




75 


u 




11-0-4 




76 


V 




11-0-5 




77 


w 




11-0-6 




78 


X 




11-0-7 




79 


y 




11-0-8 




7A 


z 




11-0-9 




7B 


[ 




12-0 




7C 


\ 




12-11 




7D 


(ALT mode) 




11-0 




7E 






11-0-1 




7F 


DEL 
(Rub out) 




12-9-7 
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A driver in the Mass Storage Operating System (MSOS) is 
the direct software interface to a hardware device. In 
some special cases, a driver is used for a pseudo software 
device. MSOS provides monitor components that aid the 
driver in performing functions normally common to all 
drivers. In order to interface to these monitor modules, 
drivers must conform to a set structure. The purpose of 
this appendix is to define the structural characteristics of 
a typical driver and to examine some of the common 
deviations from this typical form. 



DRIVER PRE-INITIATOR 
FUNCTIONS 



When a user makes one of the following monitor requests, a 
driver is entered: READ, WRITE, FREAD, FWRITE, or 
MOTION. The read/write request processor (RW) handles 
read/write requests while T14 handles the tape motion 
requests. This typical driver can be main- or mass-memory 
resident as are most MSOS drivers. The driver is scheduled 
with an indirect monitor request using words and 1 of the 
driver physical device table. 



The address in word 1 of the physical device table causes 
entry to the driver initiator (memory-resident driver) or to 
the initiator handler entry of MMEXEC (mass-resident 
driver). MMEXEC moves the driver from mass memory to 
its driver buffer (when space is available) and jumps to the 
first location of the driver (not the initiator), passing the 
physical device table address in the Q register and the 
driver memory location in the A register. The pre-initiator 
driver function is to compute the actual memory locations 
of its initiator, continuator, and error sections and place 
them in the physical device table. 



The following is a typical sequence: 



START STQ 

SAVEPDT ADDRESS 

TRA Q 

ADD 

STA- 

TRQ 

ADD 

5TA- 



I 



HOLD DRIVER LOCATION 
=XI1799-START 

ENDIN,I SAVE INITIATOR ADDRESS 
A 

=XC1799-START 

EDCGN,I SAVE CONTINUATOR 
ADDRESS 
ADQ =XE1799-START 
STQ- EDPGM.I SAVE DIAGNOSTIC ERROR 

ADDRESS 
JMP* to initiator section 



NOTE 

The I register is the address of the 
physical device table. 



DRIVER INITIATOR 
FUNCTIONS 

The driver initiator sets up the hardware for its desired 
function including positioning the device to the start of 
data area if needed and initiating the user request. The 
following is a typical event sequence: 

1. Store the address of the physical device table in the I 
register. 



11799 



STQ- 



I 



SAVEPDT ADDRESS 



Enter the find-next-request module (NFNR) to set up 
the request and fill in the physical device table (PDT) 
information. This includes the type of transfer and 
address of the I/O buffer (or data word) in core. 

EFNR RTJ (AFNR) 

JMP* EXIT 

(initiator functions 

A return is made to JMP* EXIT if no requests remain to 
be serviced or to one location beyond if a request is 
active. At EXIT: 



EXIT 



JMP+ 



MAS300 



EXIT - NO MORE 
REQUESTS 



LDQ- 


EPTR,I 


LDA- 


(ZERO),Q 


ARS 


9 


AND- 


LPMSK+5 


INA 


-14 


SAN 


NOMOTN 



The FNR routine will set up physical device table 
information as defined in appendix B for driver use. 

3. The driver should then check if this is a MOTION 
request by examining the physical device table: 

REQUEST ADDRESS 

GET REQUEST CODE WORD 

ISOLATE RC 

MOTION = RC 14 

SKIP, NO MOTION 

(Process motion request or, if motion requests are not 
performed by the driver, go to complete request.) 

4. The driver then initiates the hardware operation by 
some function command. 

5. The diagnostic clock is set to allow for a diagnosis of 
lost interrupts. The time interval is in increments of 
seconds and is typically very long compared to expected 
response time. 

ENA 3 3 SECOND TIMEOUT 

STA- EDCLK,I PERIOD IN PDT 

JMP- (ADISP) EXIT TO DISPATCHER 

6. The driver is now inactive until an interrupt occurs. 
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DRIVER CONTINUATION 
FUNCTIONS 



DRIVER DIAGNOSTIC ERROR 
FUNCTIONS 



The driver continuator section responds to the device 
interrupts and continues operations begun by the driver 
initiator section. Two general types of continuator exist: 

• The positioning phase is completed and data transfer 
can be initiated. 

O Data transfer is completed and should be checked. 



The following is a typical event sequence: 

1. The driver is entered from the SYSDAT interrupt 
response routine for the device with the physical device 
table address in the Q register. The driver first saves 
the physical device table address: 



C1799 STQ- 



SAVE PDT ADDRESS 



2. It is possible to get extraneous interrupts (interrupts 
not caused by driver requests) from a hardware device. 
The driver first checks for these extraneous interrupts: 

a. Examine the logical unit word of the physical 
device table to see if it is zero; if so no request is 
in progress. 

LDA- ELU,I LOOK AT LU WORD 

SAN NGHOST SKIP W NON-ZERO 

(Clear controller of device) 

JMP- (ADISP) IGNORE INTR 

b. Examine the device status for interrupt. 
LDQ- EWES.I 

INP REJECT-* 

(Look at the status bit.) 

Clearing the controller at this point may not be 
advisable, depending on the device. Something 
must be done to keep the current request 
progressing and not allow further ghost interrupts. 

If the interrupt status is not present, an eventual 
exit should be made to the dispatcher (if the above 
action has been taken). 

3. Clear the diagnostic clock physical device table word so 
the diagnostic timer module does not check for 
timeouts. 

ENA -1 SET CLOCK MINUS 

STA- EDCLK,I 

4. Continue the request processing until completion. 

5. When the request is completed, the complete request 
module is entered, 

RTJ- (ACOMPR) COMPLETE REQUEST 



The driver error entry is used when the diagnostic timer 
counts the EDCLK word of the physical device table down 
to zero. Entry is with the physical device table address in 
Q: 



E1799 



STQ- 



SAVEPDT ADDRESS 



The error code (code = 0) for timeout should then be passed 
to the driver error handling section. 



DRIVER ERROR HANDLING 

The driver should diagnose as many specific errors as 
possible for the hardware device. The driver should save 
the hardware status in the ESTAT2 physical device table 
word. All additional hardware status words should be saved 
in additional physical device table words for reference. 

The normal driver error sequence is: 

1. Set bits 13 through 15 of the physical device table 
EST ATI word, as noted in appendix B. 

2. Use the MAKQ routine to set up short data transfers 
and the failed Q register. 

RTJ+ MAKQ 

3. Use the engineering file to log the error. 
RTJ+ LOG 

4. Exit to ADEV to report the error (see Alternate Device 
Handler in section 2). 

JMP+ ALTDEV 

The request is completed with error, and the initiator 
of the driver is resclieduled. 



DRIVER DIAGNOSTIC UNIT 
HANDLING 



If a driver is to make use of a diagnostic logical unit, 
appropriate coding is needed in SYSDAT as well as in the 
driver. SYSDAT must include appropriate entries in all the 
log tables for the diagnostic logical unit and the physical 
device table must use a word to store the diagnostic lu for 
the driver. 

For example, the LOGIA table needs an entry like this: 



X17990 ADC 



P17990 DIAGNOSTIC 
1799 UNIT 



JMP* EFNR 



GO TO LOOK FOR MORE 
REQUESTS 



(P17990 is the start of the physical device table for 1799 
unit 0.) 

LOGl and LOG2 also need proper entries for the diagnostic 
lu. In the physical device table, an equals statement is 
used to calculate the diagnostic lu. For example: 

EQU U17990 (X17990-LOG1A) 
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Then, in the physical device table some additional words, 
for instance 19 (any word beyond 15 can be used) is used to 
store the diagnostic logical unit. For example: 



ADC 



U17990 



19 



DIAGNOSTIC LOGICAL 
UNIT 



GENERAL COyMEMTS 



The following general information items should be 
considered: 



Now the driver can make use of the diagnostic lu in 
SY5DAT. In the driver's equal statements region there 
should be an EQU to locate the PHYSTB diagnostic logical 
unit. For example: 



EQU 



DIAGLU(19) 



Then at the end of its error processing would be the 
following typical sequence: 



LDA 


DIAGLU,I 


Get diagnostic lu. 


SUB 


LU,I 


Compare against 
current lu. 


SAN 


NOT DLU 




RTJ- 


COMPRQ 


Complete request. 


JMP* 


INI+1 


To find next request 


NOT DLU RTJ+ 


MAKQ 


set up error info 


RTJ+ 


LOG 


transfers to log error 


JMP* 


ALTDEV 


to alternate device. 



9 Driver must not hang on INP or OUT instructions, but 
exit with error on rejects. 



Drivers are made effectively re-entrant by MSOS so 
that each individual driver need not be re-entrant. 



& Drivers that handle multiple devices on a single 
controller must take care of the overlap operations 
and interrupt handling with additional logic. 



O Drivers should use words through 15 of the physical 
device table only as specified in appendix C. 
Additional words can be added for special needs. 
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This appendix describes the flexible disk drive (FDD) utility 
program FDUTIL. 

The purpose of FDUTIL is to provide the user with a simple 
method of transferring data from external media to a 
diskette in the formats specified. Because FDUTIL 
accepts input only from the standard input device, FDUTIL 
control records must be embedded in the data to be 
transferred. 

When writing to flexible disks, the write-enable switch on 
the console must be on. Occasionally when re-using 
diskettes, a read-only diskette will be encountered and an 
LUxxFAILED 13 will occur even though write enable is on. 
If the diskette is to be reused an *UNL,lu motion request 
from the job processor will generate the motion request to 
clear the protect bit. 

The program executes as a job on a CYBER 18 computer 
using MSOS. It requires an FDD controller (1833-5) and at 
least one FDD transport (1865-x). 

This appendix describes the FDUTIL requests, error 
processing, operator intervention procedure, bad track 
information, FDD output formats, and diskette addressing. 



FDD UTILITY REQUESTS 

When FDUTIL is executed, a request record is input from 
the standard input device. It is then output on the standard 
list device and processed. Assuming there were no errors, 
another request record is input and the procedure is 
repeated until a terminate request record is input. 
FDUTIL terminates and returns control to the operating 
system. An option that causes a pause between request 
records allows operator intervention. 

The set of FDD utility requests is: 

• *A - Absolutize relocatable binary programs and write 

to a diskette 

• *B - Input absolute binary programs and write to a 

diskette 

• *H - Input ASCII records and write to a diskette 

• *C - Copy diskette to diskette 

• *V - Verify diskette with diskette 

• *F - Define the format 

• *S - Set for operator Intervention 

• *R - Reset for no operator intervention 

• *Z - Terminate the FDUTIL program 

• *D - Initialize directory 

• *G - Copy binary and build directory 



Each input request record contains an asterisk in the first 
character position and an alphabetic character (A, B, D, O, 
H, F, S, R, or Z) in the second position. The optional 
parameters that follow are separated by commas. The 
parameters are located in fixed positions as specified by 
each request. All numeric parameters are in hexadecimal 
code except lu, which is in decimal code. A numeric 
hexadecimal parameter (except for lu which is in decimal) 
must be right justified in its field; that is, the field is filled 
with leading zeros or blanks. For example: 

...,01A,... 



...,A1A,... 

An alphabetic field must be left justified with trailing 
spaces. For example, the symbol PGM in a six-digit field 
must be specified as: 

...,PGMAA/NA,... 



*A, ABSOLUTIZE REQUEST 

This causes relocatable binary programs that are input 
from the standard binary input device, to be absolutized 
and output to a diskette. Output may be in binary or in 
deadstart format. Provision is made for starting any 
program at a particular logical sector address. The format 
of the absolutize request is: 

*A,lu 

VJherei 

lu is the logical unit of the diskette used for output, 
represented as three decimal digits (positions 
4-6). 



Program Name Specification Record(s) 

Program name specification (*) records may follow the *A 
request. An * record specifies the next starting logical 
sector address for a particular program name and/or the 
format of the output. If there are no * records, the next 
starting logical sector address is assumed to be the next 
sector; all data is output in binary format. Only program 
names which define new sector addresses and/or output 
format need be specified. The format of the program 
name specification record is: 

*,pgmnam,ssa,o,p 

Where: 

pgmnam is the name of the program, represented as 
six alphanumeric characters (positions 
3-8), left justified with blank fill. This 
name must agree with the program name 
in the NAM record of the corresponding 
relocatable binary program (see MSOS 5 
reference manual). 
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is the next starting logical sector address, 
where the program is to be written. It is 
represented as three hexadecimal digits 
(positions 10-12). If blank or zero, the 
starting logical sector address is the 
next sector. 

is the output format identifier, represented 
as one character (position 14). If the 
character is an alphabetic D, the output 
is in deadstart format to load/execute 
micro memory; if blank or not a D, the 
output is in binary format. This field 
and the p field (described below) remain 
in force for subsequent binary programs 
until the next * record matches a 
program name. 

is the starting micro page number, 
represented as one hexadecimal digit 
(position 16). This field has meaning 
only if deadstart format has been 
selected (see above). It will cause the 
deadstart output to start loading and to 
begin execution at the first micro 
instruction of the specified micro page. 
If blank, micro page zero is assumed. 



*T, Program Name Specification Termination 

A termination record must follow any program name 
specification records. This record must be present even if 
there are no * records. The format of the termination 
record is: 



*T, Relocatable Binary Program Termination 

Following the relocatable binary programs must be a 
terminating record. The format of the terminating record 
is: 

*T 

\Miere: 

*T is in positions 1 and 2. 

\Mien this record is read, the following message is output to 
the standard list device: 



Position 

1-2 

16-18 



Description 



*T 



Logical next sector address (next sector 
following the end of the program just 
placed on diskette) 



*B, BINARY REQUEST 

This request permits previously ' absolutized binary 
programs to be input from the standard' binary input device 
and output to a FDD diskette. Provision is. made for 
starting at a particular logical sector address. The format 
of the binary request is: 

*B,lu,ssa 

Vfriere: 



*T 



Where: 

»T is 
in positions 1 and 2. Note that neither the * or *T records 
are listed. 

One or more relocatable binary programs must follow the 
program name specification termination (*T) record. The 
program names of the relocatable binary programs must be 
in the same corresponding order as the names which were 
specified on the program name records in the *A request. 

The following information for each binary program input is 
output to the standard list device: 

Position Description 

2 *, if deadstart output specified; , if 

binary output specified. 

3-8 Program name of relocatable binary 

11-lA Program length in 32-bit hexadecimal 

format 

15 *, if a next starting sector address 

specified 

16-18 Logical starting sector address of 

program 

21-66 Comment information or the NAM 

record of the program 



lu is the logical unit of a diskette used for output, 
represented as three decimal digits (positions 
4-6). 

ssa is the starting logical sector address, where the 
block of binary programs is to be written. It is 
represented as three hexadecimal digits 
(positions 8-10). If blank or zero, the starting 
logical sector address is the next sector. 

One or more absolutized binary program(s) follow the 
binary request (*B) record. (For details, see *P statement 
of LIBEDT described in the MSOS 5 reference manual.) 

The following information for each binary program input is 
output on the standard list device: 



Position 



2-4 



8-10 



Description 

Sequential count of binary programs 
(for instance, 001 is output for program 
1). 

Logical starting sector address of 
program. 



The absolutized binary programs must be followed by a 
termination record. The format of the termination record 
is: 

*T 

Where: 

*T is in positions 1 and 2. 
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When the record is read, the following message is output on 
the standard list device: 



VMen the record is read, the following message is output to 
the standard list device: 



Position 



1-2 



8-10 



Description 



*T 



Logical next sector address (next sector 
following the end of the program just 
placed on diskette) 



*H, ASCII REQUEST 

This permits ASCII records from the standard input device 
to be output to a diskette. The ASCII characters are to be 
packed two per 16-bit word. Provision is made for starting 
at a particular logical sector address, for ignoring spaces 
(blanks), and including parity. The format of the ASCII 
request is: 

*H,lu,ssa,q,p 

Where: 

lu is the logical unit of the diskette used for output, 
represented as three decimal digits (positions 
4-6). 

ssa is the starting logical sector address, where the 
block of ASCII reocrds is to be written. It is 
represented as three hexadecimal digits 
(positions 8-10). If blank or zero, the starting 
logical sector address are the next sector. 

q is the ignore spaces (blanks) option, represented 
as one character (position 12). If the character 
is an alphabetic I, spaces are ignored; if blank 
or not an I, spaces are treated as other 
characters and are output to the diskette. 

p is the even parity option, represented as one 
character (position 14). If the character is an 
alphabetic E, each ASCII character is output 
with even parity (using the most significant 
eighth bit); if blank or not an E, no parity is 
included. 



NOTE 

If ASCII records are to be used for the 
deadstart operation, the even parity 
option must be selected. 



Position 
1-2 
8-10 



Description 



*T 



Logical next sector address (next sector 
following the end of the program just 
placed on diskette) 



•C, COPY REQUEST 

This request specifies that one or more sectors on a 
diskette is to be copied to a like number of sectors on 
another (or the same) diskette. After each sector is 
written, that sector is read and compared with the input 
sector to validate that the data is correct. The format of 
the request is: 

*C,lul,lu2,ssl,esl,ss2,num 

Where: 

lul is the logical unit of the diskette holding the 
input (copied) data, represented as three 
decimal digits (positions 4-6). 



Iu2 is the logical unit of the diskette holding the 
output data, represented as three decimal 
digits (positions 8-10). It may be the same 
logical unit as specified by lul. If blank or 
zero, logical unit lul is used. 

ssl is the starting sector address of the data to be 
read from logical unit lul. It is represented as 
three hexadecimal digits (positions 12-14). 



esl is the ending sector of the data to be read from 
logical unit lul. It is represented as three 
hexadecimal digits (positions 16-18). If blank 
or zero, starting sector address ssl is used. 



ss2 is the starting sector address where the data is 
to be written on logical unit lu2. It is 
represented as three hexadecimal digits 
(positions 20-22). If blank or zero, starting 
sector address ssl is used. Note that the 
ending sector address where the data is to be 
written on logical unit lu2 is implied: (ss2 + 
esl - ssl). 



One or more ASCII record(s) follow the ASCII request (*H) 
record. The following information is output to the 
standard list device when the first ASCII record is input. 



Position 



8-10 



Description 
Logical starting sector address 



The ASCII records must be followed by a termination 
record. The format of the termination record is: 

»T 

Where: 

*T is in positions 1 and 2. 



the number of times the copy operation is to 
be repeated. It is represented as three 
hexadecimal digits (positions 24-26). If blank 
or zero, the number of times is one. This field 
is provided for diagnostic or performance 
testing. 



NOTE 

Console write enable causes both 
diskettes to be write enabled. Be sure 
that the unit reverse switch is in the 
position desired so that the copy 
proceeds in the direction desired and not 
in the opposite direction. 
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•V. VERIFY REQUEST 

This request causes one or more sectors on a diskette to be 
compared (verified) with a like number of sectors on 
another (or the same) diskette. The format is: 

* V ,lul,lu2,ssl,esl,ss2,num 

Where: 

lul is the logical unit of the first diskette, 
represented as three decimal digits (positions 
4-6). 

Iu2 is the logical unit of the second diskette, 
represented as three decimal digits (positions 
8-10). It may be the same logical unit as 
specified by lul. If blank or zero, logical unit 
lul is used. 

ssl is the starting sector address of logical unit lul 
to be verified, represented as three 
hexadecimal digits (12-14). 

esl is the ending sector address of logical unit lul to 
be verified, represented as three hexadecimal 
digits (positions 16-18). If blank or zero, 
starting sector address ssl is used. 

ss2 is the starting sector address of logical unit lu2 
to be verified, represented as three 
hexadecimal digits (positions 20-22). If blank 
or zero, starting sector address ssl is used. 
Note that the ending sector address of logical 
unit lu2 is implied: (ss2 + esl - ssl). 

num is the number of times the verify operation is to 
be repeated. It is represented as three 
hexadecimal digits (positions 24-26). 

if blank or zero, the number of times is one. 
This field is provided for diagnostic or 
performance testing. 



*F, DEFINE FORMAT REQUEST 

This request specifies the diskette format to be used. It 
remains in effect until changed by a subsequent *F 
request. Current supported formats are: 

CDC format - 96 (60^5) 16-bit words per sector and 
19 (1326) sectors per track. 



IBM format 



64 (40^^) 16-bit words per sector and 
26(1A25) sectors per track. 



This request does not cause any FDD I/O, it merely 
specifies the format to the FDUTIL program. The default 
condition causes CDC format to be used. The format of 
the request is: 

*F,wps,spt 

Where: 

wps is the number of words per sector, represented 
as three hexadecimal digits (positions 4-6). If 
blank or zero, the default is 60^6 (CDC 
format). 



spt is the number of sectors per track, represented 
as three hexadecimal digits (positions 8-10). If 
blank or zero, the default is IJj^g (CDC 
format). 



*S. SET OPERATOR 
INTERVENTION REQUEST 

This request specifies that before each subsequent request, 
the FDIJTIL pauses (waits) until the operator indicates that 
the next request is to be processed. The format of the 
request is: 

*S 

Note that the operator intervention option is in. effect 
before the first request if the standard input device is the 
standard comment input device (teletypewriter or CRT). 



*R, RESET OPERATOR 
INTERVENTION REQUEST 

This request specifies that any previous *S request be 
ignored; that is, that there be no operator intervention 
between requests. The format of the request is: 

*R 



*D, ODS INITIALIZE DIRECTORY 

This request specifies that the CDS directory area (sectors 
9-10) is to be initialized to -1. A starting sector of 
04626 is placed in the first directory. The request 
format is: 

*D,LUN 

Vfriere: 

LUN is the logical unit of the diskette to be 

initialized, represented as three 
decimal digits (positions 4-6). 



•O, ODS COPY AND BUILD 
DIRECTORY REQUEST 

This request specifies a copy of an absolutized ODS 
monitor or test and the building of an ODS directory. Each 
directory entry has the form: 

Word 1 - ASCII-coded first two characters of 
program test name ($4141) 

Word 2 - Second two characters of test name ($4141) 

Word 3 - Last character of test name ($4120) 

Word 4 - Sector address of test (hexadecimal) 

Word 5 - Length of test binary (hexadecimal) 

Word 6 - Not used ($FFFE) 



F-4 



96769390 F 



The request format is: 



*Z. TERMINATE FDUTIL REQUEST 



* O, LUN 
♦, PGMNAM 

Program Binary 



This request specifies that the FDUTIL be terminated. 
Control is returned to the operating system. The format of 
the request is: 

♦Z 



*T 
Where 

LUN is Hexadecimal logical unit of diskette 

*T is termination 

Output information (standard list device) 

AAAAA start=XXXX length=XXXX next available 
sector=XXXX 

Where 

AAAAA is MON or the name of the test loaded 

XXXX is four hexadecimal digits. 

Start is the hexadecimal diskette sector at which 
the new monitor or test is loaded 

Length is the length of load in hexadecimal words 
next available. 

Next is the next diskette sector available for 

Avail- loading. (Last used +1) 

able 

Sector 



When a monitor or test is loaded on a diskette that has a 
previous copy of that monitor or test, the new version will 
be loaded over the old if the old version occupied sufficient 
space to load the new. If there is not sufficient space, the 
new version will be loaded at the next available sector. 
Since the directory is changed to reflect the new version, 
the old version is inaccessible to the user, whether it was 
or was not destroyed. There is no other provision for 
allocating unused space on the diskette. 



The error messages are: 

0250 - Program name specified does not match binary 
input. 

This message may imply that an attempt is 
being made to load a level I test on a level II 
diskette or to load a level II test on a diskette 
which does not have a level II monitor as its 
first directory entry. 

1011 - Operator is probably attempting to use a 
diskette for which the ODS' directory has not 
been initialized. This error may also indicate 
that the ODS directory is full (unlikely). 



FDUTIL ERROR PR0CESS8NG 



When FDUTIL detects an error, the following message is 
output to the standard list device: 

FDD UTILITY PROGRAM, ERROR xxxx, RESTART 
OPERATION 

Where: 

xxxx is an error code. The error codes and their 
meanings are listed in table F-1. 

After the error message is output, the FDUTIL is 
automatically restarted. If an *R is in effect, there will be 
no opportunity to correct the error and many more may 
occur before the utility finds a valid command. 

Table F-1 describes the FDUTIL error codes. The 
characters in column 2 describe the error codes. The 
characters have the following meaning: 

- An incorrect user record. 

• The resources of the FDUTIL program and/or computer 
are not sufficient to execute. 

+ A possible irrecoverable hardware problem. 

OPERATOR INTERVENTION 
PROCEDURE 

If an *S request is in effect, the FDUTIL program pauses 
before each request until the operator indicates that the 
next request is to be processed. The purpose of the pause 
may be to: 

9 Remove a diskette and insert another one 

• Ready a FDD drive (that is, diskette inserted and drive 
door closed) 

• Change the FDD switches 

• Readjust the input records after an error 

Whenever a pause occurs, FDUTIL outputs a message to the 
standard comment device: 

READY FDD(S), THEN PRESS CARRIAGE RETURN 

After the operator performs the necessary function, he 
presses the carriage return key. 
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TABLE F-1. FDUTIL ERROR CODES 



Code 



Type 



Meaning 



Olio 

0120 

0130 

0140 
0210 

0220 

0230 

0240 

0250 

0260 

0270 

0280 

0290 
0299 

0610 

0620 

0630 

0710 
0810 

0910 

1010 

1101 
1110 



Illegal control record. Position 1 of the request record does not contain an asterisk, or 
position 2 does not contain a legal character (A, B, C, F, H, R, S, V, or Z). 

Illegal start or end address. The ending sector address is less than the starting sector 
address on a *C or *V record. 

Illegal sector address. The computer last sector address to be written (*C) or compared 
(*V) is greater than the maximum allowable sector address. 

Illegal *F request. The specific number of words/sector and/or sector/track is incorrect. 

Illegal record after an *A record. Position 1 does not contain an asterisk, or position 2 
does not contain a comma (program name specification) or T (terminate). 

Too many program names specified. More than 20 program names have been specified. To 
increase the number of program specification names, FDUTIL would need to be reconfigured. 

Illegal record after program name specifications. Record is not a relocatable binary 
record on an *T record. 

No binary program entered. A *T record (terminate) was encountered without any relocatable 
binary program being loaded. 

Program specification error. One or more of the program specification names are not binary 
programs. If using *0, see special instructions.^ 

Illegal NAM record. NAM record encountered was not the first record of a relocatable 
binary program. 

Illegal relocatable binary record. An undefined or illegal (BZS or EXT) relocatable binary 
record has been encountered. 

Illegal first record of relocatable binary program. The first record of a relocatable 
binary program was not a NAM record; instead it was an ENT, SFR, or RBD record. 

No end byte encountered. No end byte encountered on last relocation byte of a RBD record. 

Program size is too large. The size of the program being loaded (plus the FDUTIL program) 
is too large to fit in the program memory area. To load such a program, the operating 
system must be rebuilt to sufficiently increase the program memroy area. 

Illegal sector address. An attempt to write (via an *A, *B, or *H request) beyond the 
maximum allowable sector address. Move the program to a lower sector address or place on 
another diskette. 

Fatal FDD input/output error. A fatal FDD input/output error has occurred. Make sure that 
the FDD unit is ready (diskette inserted and door closed) and the switches are set properly 
(viz., write enabled, initialize enabled, and unit reverse). If the above has been done, 
retry with another diskette and/or request maintenance support. 

Written data not read correctly. The written data, when read, did not compare exactly. 
Retry and/ or request maintenance support. 

Illegal FDD logical unit. The specified logical unit is not a FDD. 

Illegal parameter. One of the parameters of the last read request record is illegal. For 
example, the sector address may be larger than the maximum allowable sector address. 

Illegal hexadecimal digit. One of the hexadecimal parameters of the last read request 
record is not a hexadecimal digit. 

Illegal diskette format. The format (IBM or CDC) of a diskette to be read or written does 

not agree with the last *F request record (if no *F record, IBM format is assumed). This 

error should only occur if a diskette is inserted to be read or written without first being 
initialized by FDUTIL program. 

Directory is FULL. See special instructions for *0. 

Error in attempt to read input from standard input device. 
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FDD OUTPUT DATA FORMAT 

Data can be stored onto the FDD diskette in four ways: 
Initialization, binary, ASCII, or deadstart. 

INITIALIZATION DATA 

Each diskette must be properly initialized before it can be 
used. When it is initialized, data words for all tracks are 
set to E5E5i5 (two EBCDIC alphabetic Vs) per IBM 
standard. Certain words in track are overwritten with 
valid information during the initialization process. 

BINARY DATA 

Binary information is output for any request that causes a 
diskette binary write (*A, *B, or *C), unless *A specifies 
deadstart format. Binary information is stored as is, 
without any extra information. 

Unused words in the last sector are filled with zeros. 



ASCII DATA 

ASCII information is output as a result of the *H request. 
Actually, there is no difference between binary and ASCII 
except by the user's interpretation of the data. 



Spaces are ignored in the text (due to I option). Unused 
words in the last sector are filled with spaces. 



DEADSTART DATA 

Deadstart information is output by either the *A request 
with the deadstart option selected or the *H request with 
the even parity option selected. Deadstart information is 
ASCII information for serial loading via the CYBER 18 
computer. This method can be used to load and execute 
programs in deadstart format from a diskette. 

For the *H request, the ASCII characters are stored two 
characters (each with even parity) without any extra 
information. 

For the *A (deadstart option selected) request, the 
program data words are converted to ASCII and stored with 
a terminal ASCII colon (for each program word) two 
characters (each with even parity per FDD word. This *A 
format assumes that the program(s) are to be loaded into 
micro memory. Control information is added to allow the 
program(s) to be loading into the starting page and each 
successive half page. Further control information is added 
at the beginning and end to properly set up the machine 
modes and to start program execution. If the program is 
being loaded on the initial deadstart sector (track 1, sector 
1), control information is appended to clear all registers 
and files. 
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Alternate device handler 1-1; 2-2 

Alternate device table, LOGl 2-1; C-1 

A/Q channel allocation 2-4 

A/Q data transfers 4-10 

A register 2-14; 8-1, 2 

ASCII conversion table D-1 

Auto data transfer 2-4 
clock table ' 2-6 
multiple A/Q device table 2-5 
single A/Q device table 2-5 
single or multiple M05 devices table 



2-6 



Binary/ ASCII 5-1 
BCD character set 



D-3 



Carriage control information 5-1 
Card reader driver 5-> 

binary format record cards 5-5 

data formats 5-3 

EOF processing and motion requests 

FREAD ASCII 5-4 

FREAD binary 5-4 

PHYSTB C-8, 9 

read ASCII 5-4 

read binary 5-4 

status and error handling 5-4 
Cartridge disk 4-1 
Cartridge disk driver 4-1 

data transfer request formats 4-1 

disk driver requests 4-2 

FREAD 4-2 

FREAD/FWRITE 4-2 

MOTION 4-2 

READ 4-2 

READ/WRITE 4-2 

Status and error handling 4-2 

WRITE 4-2 
Character editing 5-1 
Clock table for ADT 2-6 
Code conversion table D-1 
Code request 1-1, 2 
Codes, equipment type C-5 
Complete request routine 1-1, 2; 2-1 
COMPRQ routine 2-1 
Console display driver 3-1 

FREAD request 3-1 

FWRITE request 3-1 

MOTION request 3-1 

READ request 3-1 

WRITE request 3-1 
Continuator 1-1 
Control point 4-3 
COSY driver 7-1 
Current control point 4-3 



5-4 



Device priority 2-1 

Data transfer 2-4 

Diagnostic clock 1-1 

Diagnostic clock counter 2-1; 4-4 

Diagnostic status buffer 4-7 

Diagnostic timer 1-1; 2-2 

Disk, cartridge 4-1 

Disk pack initialization format 4-7 

Disk-to-tape utility drivers 9-1 

Driver coding structure E-1 

continuation functions E-2 

diagnostic error functions E-2 

diagnostic unit handling E-2 

initiator functions E-1 

pre-initiation functions E-1 
Dual channel CLA, ITOS2/COMM18 (1843-1) 

Data reception 3-3 

MOTION 3-2 

READ/FREAD 3-2 

WRITE/FWRITE 3-2 
Dummy driver 7-1 



3-1 



End-of-file processing 1-4 
Engineering file 2-3, 4; 4-7 
Equipment interrupt assignments 
Equipment type codes C-5 
Error flag 1-1 
Error recovery 4-3; 6-1, 4 
Exit processor request 1-1 



Find-next-request routine 1-1; 2-1 

Flag, error 1-1 

Flexible disk driver, ITOS 2 4-7 

data formats 4-8 

error recovery 4-8 

FREAD/FWRITE 4-8 

MOTION 4-8 

READ/WRITE 4-8 
Flexible disk driver, MSOS 5 4-9 

compare data logic 4-13 

data formats 4-9 

error recovery 4-10 

flexible disk commands 4-12 

flexible disk utility 4-13 

FREAD/FWRITE 4-10 

MOTION 4-11 

overlay requests 4-13 

PHYSTB C-12 

READ/WRITE 4-10 

unprotected requests 4-13 
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Flexible disk drive utility, (FDUTIL) F-1 

absolutize request F-1 

ASCII data F-7 

ASCII request F-3 

binary data F-7 

binary request F-1 

copy request F-3 

deadstart data F-7 

define format request F-4 

FDD output data format F-7 

FDUTIL error codes F-6 

FDUTIL error processing F-5 

Initialization data F-7 

ODS copy and build directory request F-4 

ODS initialize directory F-4 

operator intervention procedure F-5 

reset operator intervention request F-4 

set operator intervention request F-4 

terminate FDUTIL request F-5 

verify request F-4 
FNR routine 2-1 
Fortran FWRITE 5-1 
FREAD request 1-1 
FWRITE request 1-1 



Glossary A-1 



Handler, alternate device 
Hang-up 1-1; E-3 



1-1; 2-2 



Initiator 1-1 
Interfaces, system 2-1 
Interrupt 

condition 1-1 

lost 1-1 

mask 1-1 

response routine 1-1; 2-4 

stack 1-1 
Input/output, (I/O) 

command 1-1 

device 1-1 

driver 1-1 

operation 1-1 

request 1-1 
I register 2-1; 8-1, 2 



Jump request 1-1 



Kernel drivers C-2 



Line printer driver 

binary/ ASCII 5-1 
character editing 5-1 
error conditions 5-2 
MOTION 5-1 
WRITE/FWRITE 5-1 



5-3 
5-3 

C-1 



6-3 



6-2 
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Line printer driver (1827-30/60/90) 5-2 

character editing 5-2 

PHYSTB C-13 

status and error handling 5-2 

WRITE/FWRITE/MOTION 5-2 
Line printer driver, ITOS 2 (1827-7) 5-3 

character editing 5-3 

PHYSTB C-14 

status and error handling 

WRITE/FWRITE/MOTION 
Logical unit table 2-1; C-1 
LOGl, alternate device table 
LOGIA, logical/physical unit table 
LOG2, task threads table 1-1; C-1 
Lost interrupt 1-1 
Low-cost tape transport 6-2 

data format 6-2 

FREAD/FWRITE records 

MOTION 6-3 

nine-track data transfers 

PHYSTB C-15 

READ/WRITE/FREAD/FWRITE 6-3 

READ/WRITE RECORDS 6-3 

record constraints 6-3 

seven-track data transfers 6-2 
Low-cost tape transport/formatter driver, 

dual mode (1860-5/6) 6-5 

data format 6-5 

error recovery 6-6 

FREAD/FV/RITE records 6-6 

MOTION 6-6 

nine-track data transfers 6-5 

PHYSTB C-16 

READ/WRITE/FREAD/FWRITE 6-6 

READ/WRITE records 6-5 

record constraints 6-5 

seven-track data transfers 6-5 



Magnetic tape drivers 6-1 

data formatting 6-1 

error recovery 6-1 

formatted requests 6-1 

motion requests 6-1 

unformatted requests 6-1 
MAKQ routine 1-1; 2-1 
Macro format 1-1, 2 

FREAD request 1-1 

FWRITE request 1-1 

MOTION request 1-4 

READ request 1-1 

WRITE request 1-1 
Malfunction, hardware 1-1 
Mass memory 

address format 1-3 

drivers 8-2 

sector address 1-3 

word address 1-3 
Mass storage address 7-3 
Monitor 1-1 
Monitor request 1-1; E-1 
Motion processing 1-4 
MOTION request 1-1, 4 
Multiple A/Q device table for ADT 2-5 
Multiple device handlers E-3 
Multiple M05 device table for ADT 2-6 
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Operating system drivers 7-1 
COSY driver 7-1 
dummy driver 7-1 
pseudo-tape driver 7-1 
software buffer driver 7-1 

Overflow register 2-1 



Parameter list 1-1, 2 

Physical device table, PHYSTB 1-1; 2-1; C-1 

Priority 

device 2-1 

scheduling 2-1 
Processor request 1-1 
Pseudo-tape driver 7-1 



Q register 1-2; 2-1, 2, 4; 3-1, 2; E-1 
Queue 

beginning 1-1 

end 1-1 

request 1-1 
Queueing of I/O requests 1-1 



READ request 1-1 

re-entrance E-3 
Request 

code 1-1, 2 

exit processor 1-1 

FREAD 1-1 

FWRITE 1-1 

I/O 1-1 

jump 1-1 

MOTION 1-1, 4 

processor 1-1 

queue 1-1 

READ 1-1 

scheduler 1-1 

TIMER 2-2 

waiting 2-1 

WRITE 1-1 
Routine 

complete request 1-1, 2 

diagnostic timer 1-1 

find-next-request 1-1 

interrtpt response 1-1 

MAKQ 1-1 



Schedule request 1-1 

Scheduling priority 2-1 

Single A/Q device table for ADT 2-5 

Single M05 device table for ADT 2-6 

Software buffer driver 7-1 

System checkout drivers 10-1 

constraints 10-1 

B18331 (SMD) and B18334 (ODD) 10-1 
System interfaces 2-1 
System initializer drivers 8-1 

driver errors 8-2 

hardware device drivers 8-1 

input drivers 8-1 

Mass-memory drivers 8-2 

operation 8-1 
Storage module drive driver (1867-10/20/40, 1868-1) 

Disk pack initialization format 4-7 

Driver description 4-2 

Driver diagnostics 4-7 

Error recovery 4-4 

PHYSTB C-IG 

Request format 4-3 
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Table of logical units 1-1 
Terminal driver, ITOS 2 (1843-2) 

Connect 3-5 

Cursor positioning 3-5 

Disconnect 3-5 

FWRITE 3-5 

MOTION 3-5 

READ/FREAD 3-5 

Request format 3-4 

WRITE 3-5 

WRITE-READ 3-5 
Terminal driver, MSOS 5 (1843-2) 

Connect 3-6 

Disconnect 3-6 

FWRITE 3-6 

MOTION 3-6 

READ/FREAD 3-6 

Request format 3-5 

WRITE 3-6 

WRITE-READ 3-6 
Timeout 

entry 1-1 

error 1-1 

period 4-3 
TIMER request 2-2 
Thread 1-1, 2 
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Waiting request 
WRITE request 



2-1 
1-1 
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